ContextQMD
Back to Medusa

{metadata.title}

www/apps/cloud/app/first-project/page.mdx

2.16.04.9 KB
Original Source

export const metadata = { title: Create your First Project in Cloud, }

{metadata.title}

After you sign up to Cloud, Medusa guides you to create your first project. You can choose from different options that work best for your use case to get an ecommerce store ready for selling.

Onboarding After Sign Up

After you sign up, you'll reach the onboarding experience with four guided paths:

  1. Start with an AI-prompt: AI-assisted project creation, ideal for AI builders and less technical users.
  2. Choose a starter: Start from a starter that Medusa has built, with a variety of cases related to B2B, product configurators, and more.
  3. Import existing project: Import a Medusa project hosted on your GitHub account or organization.
  4. Use AI Tools: Access AI-powered assistance tools for project setup and development workflows.

After following any of the above flows, you'll have an ecommerce project deployed to Cloud. Choose the option that best fits your use case.

Option 1: AI-Assisted Project Creation

Create a new Medusa project with the help of your AI agent. This is ideal for users who heavily rely on AI-assisted flows or those with less technical or Medusa experience.

To follow the AI-assisted project creation flow:

  1. In the onboarding page, click on "Start with an AI prompt".
  2. Copy the prompt shown on the new page and give it to your AI agent.
  3. Your AI agent will perform the necessary setup to run a Medusa application locally, preparing for deployment on Cloud.
  4. Once the local setup is done, the AI agent will instruct or assist you in pushing your local project to GitHub.
  5. After pushing your project to GitHub, return to Cloud.
  6. Click on Import repository in the second step of the AI creation flow.
  7. Follow the project creation steps. Refer to the Projects guide for more information on creating projects.

Once your project is deployed, you're ready to use your ecommerce store and start selling.

Option 2: Choose a Starter

Choose from a variety of pre-built templates that fit your use case to get started quickly. This option is ideal for users with common use cases like B2B and quiz-to-product. By choosing a template, you'll have an ecommerce store with the necessary foundation, with the flexibility to customize it for your unique store.

To create a project from a starter:

  1. In the onboarding page, click on "Choose a starter."
  2. Browse the list of starters to find the store that fits your use case.
  • To preview a store, click on the Preview button. This opens a new page with a live preview of the store where you can browse its different pages and try its features.
  • To get a full overview of the store's features and details, click on its image. This opens a pop-up with details on the store and the storefront framework used.
  1. To create a project from a store, click on Clone.
  2. Follow the project creation steps. Refer to the Projects guide for more information on creating projects.

Once your project is deployed, you're ready to use your ecommerce store and start selling.

Option 3: Import Existing Project

If you're a Medusa user with a local project, you can follow the third path to import your existing Medusa project from GitHub.

To create a project from your GitHub repository:

  1. In the onboarding page, click on "Import existing project."
  2. Follow the project creation steps, including choosing your repository to import it. Refer to the Projects guide for more information on creating projects.

Once your project is deployed, you're ready to use your ecommerce store and start selling.

Option 4: Use AI Tools

Access AI-powered assistance tools that can help with project setup and development workflows. This option provides a collection of AI tools designed to streamline various aspects of working with Medusa projects.

To access AI Tools:

  1. In the onboarding page, click on the "AI Tools" card.
  2. This opens an AI Tools drawer with various AI-powered assistance tools available for project setup. Access the MCP server and agent skills that can help you build your ecommerce store.

The AI Tools option is ideal for developers who want to leverage AI assistance throughout their project setup and development process.

Next Steps

After completing the get started flow and creating your first project, you can: