Creating new projects

After setting up your FastStore monorepo, you can create new projects for additional stores, brands, or modules using the fsp create command. This is useful when you need to add a new storefront, extend your monorepo with additional modules (Buyer Portal Checkout, VTEX Sales App), or create projects for different brand variants within your organization. You can create a Buyer Portal Checkout (checkout) or Sales App (sales-app) project without a Product Discovery Experience (discovery) project if FastStore isn't your storefront.

The fsp create command automatically creates the project directory with the necessary structure and updates your faststore.json configuration file with the new project settings, including the path and port allocation.

Run the following command in your terminal at the root of your monorepo:

Or using npm:

Consider you want to create a new Discovery project for a different brand. The fsp create command will guide you through an interactive setup by asking for:

1. Account name: The VTEX account for which you're creating the project (example: store-a, brand-store-1).
2. Module type: The module you want to initialize (discovery, checkout, or sales-app). For Buyer Portal Checkout (checkout) and Sales App (sales-app), continue with Setting up Buyer Portal Checkout or Setting up Sales App extensions after you create the project.
3. Project path: The directory path where the project will be created (example: ./packages/store-a, ./store-a/checkout).

In your terminal, you should answer the questions as follows to create a new Discovery project for a different brand:

You can also include all parameters directly in your command:

Or using npm:

After running the command, your monorepo structure will be updated with:

And your faststore.json will be automatically updated with the new configuration: