Skip to main content

Creating Your First ValkyrAI Project

Ready to build something useful? Let's create a Project, then use it to drive strategy, goals, tasks, app generation, ValorIDE refinement, and deployment.

What We'll Build​

In this guide, we'll create a simple product catalog app Project 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 the Valhalla dashboard.
  2. Open the LCARS sidebar and choose Business > Projects.
  3. Click New Project.
  4. Choose a name for your project, such as "My First Catalog".
  5. Select a project type. For this guide, use App generation.
  6. Add a short brief with the success criteria and first milestone.
  7. Click Create Project.

The Project record now becomes the workspace for the rest of the build. It can point to the Strategy, Goals, Tasks, generated Application, deployment, MCP publication, and GrayMatter memories that explain decisions along the way.

Step 2: Define Your Product Object​

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

  1. Navigate to API Studio or the OpenAPI Design Center
  2. You'll see the pre-made Product object from the template
  3. Customize the Product object to fit your needs:
Interactive playgrounds load on the client. Refresh in a browser to edit this lesson.
  1. Save the spec

Step 3: Generate Your Application​

  1. Open Application Builder or the app generation flow
  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 generation completes, link the generated Application back to the Project
  4. Advance the Project stage to Generate app

Step 4: Customize with ValorIDE​

Now let's build the actual user interface:

  1. Open or download the generated project 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 use the generated clients and components ThorAPI created
  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 updates the app and can write durable project decisions to GrayMatter

Step 5: Preview Your App​

  1. Preview the generated app from the app workspace or deployment flow
  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 created a real Valhalla Project: strategy, tasks, generated app artifacts, ValorIDE work, deployment follow-up, and memory all have one place to attach.

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.