Skip to main content

Creating Your First ValkyrAI Project

Ready to build something awesome? Let's create your first project using ValkyrAI's powerful tools!

What We'll Build​

In this guide, we'll create a simple product catalog app that lets you:

  • Add and manage products
  • View product details
  • Filter and search through products

Don't worry - you won't need to write any complex code!

Step 1: Create a New Project​

  1. Log in to your ValkyrAI dashboard at app.valkyr.ai
  2. Click the "New Project" button
  3. Choose a name for your project (like "My First Catalog")
  4. Select the "Product Catalog" template
  5. Click "Create Project"

Step 2: Define Your Product Object​

Now we'll tell ThorAPI what our products should look like:

  1. Navigate to the "Spec Editor" tab
  2. You'll see the pre-made Product object from the template
  3. Customize the Product object to fit your needs:
components:
  schemas:
    Product:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
          description: Name of the product
        description:
          type: string
          description: Detailed product description
        price:
          type: number
          format: float
          description: Product price in dollars
        category:
          type: string
          description: Product category
        imageUrl:
          type: string
          format: url
          description: URL to product image
      required:
        - name
        - price
  1. Click "Save Spec"

Step 3: Generate Your Application​

  1. Click the "Generate" button at the top of the screen
  2. ValkyrAI will show you what it's creating:
    • Database tables for your products
    • API endpoints for managing products
    • Frontend components for displaying products
  3. When it's done, you'll see a "Generation Complete" message

Step 4: Customize with ValorIDE​

Now let's build the actual user interface:

  1. Click "Open in ValorIDE"
  2. In the chat window, tell ValorIDE what you want to build:
Create a product catalog page that shows all products in a grid. 
Each product should display its image, name, price, and a "View Details" button.
Also create a product detail page that shows all information about a selected product.
  1. ValorIDE will create these pages for you using the components ThorAPI generated
  2. Review what ValorIDE created, and ask for any changes you'd like:
Can you add a search bar at the top of the catalog page that filters products by name?
  1. ValorIDE will update your app with the requested changes

Step 5: Preview Your App​

  1. Click the "Preview" button
  2. Your app will open in a new browser tab
  3. Try out all the features:
    • Browse products
    • Search for products
    • View product details

Congratulations!​

You've just built your first application with ValkyrAI! No coding required - just describing what you want in plain English.

Next Steps​

Now that you've built your first app, try:

Remember: ValkyrAI grows with you! As you learn more, you can make your apps more complex and powerful.