Create Stackbit Project

There are a number of different approaches to creating new Stackbit projects. This doc first helps you identify the proper working mode for your new project, then provides the steps necessary to begin working with Stackbit.

Typical Learning Paths#

While everyone's path is unique, we've seen our users have the most success when following these paths.

Non-Developers (Marketers, Designers, Leadership, etc.):

1. Create a demo site and click around to get an initial feel for Stackbit.
2. Talk with an expert to learn more about Stackbit and ask specific questions.

Developers:

1. Learn the basics by following the tutorial and reading core concepts.
2. Create a new local project or immediately begin integrating Stackbit into their site (also by working locally).

Identifying the Right Working Mode#

Here are the common scenarios in which users create new projects, organized by your role and what you aim to achieve with your Stackbit project.

New Projects for Non-Developers#

Stackbit projects are generally built by developers. If you're looking to build a website and don't have a developer, talk to us.

Otherwise, content editors, designers, and other non-technical users looking to demo or evaluate Stackbit should create a new project from a starter.

Be sure to choose a full website demo (not a minimal starter) to see a wider range of capabilities.

New Developer Project#

Developers have a number of options, depending on what you're looking to accomplish. Here are some suggestions, though you can also explore the creation modes below or contact us if you're unsure how to proceed.

• Learning the Basics: Read How Stackbit Works and follow a tutorial with your preferred stack.
• Evaluating Stackbit: Follow a getting started tutorial, using your preferred stack.
• Starting a Project from Scratch: After learning the basics, use npx create-stackbit-app to begin locally.
• Integrating Stackbit into an Existing Project: After the basics, follow the appropriate framework guide.
• Adding Content Editors: Create a new cloud project from a GitHub repository.
• Duplicate Existing Project: Create a new cloud project from an existing GitHub repository.

Creation Modes#

Below are a number of scenarios that each explain a specific mode for starting a new project.

Starting with Local Development#

When you want to start a new project locally from scratch, use the create-stackbit-app command:

npx create-stackbit-app

New Cloud Project from Starter#

To create a new project from a starter or demo, visit the new project screen and choose the appropriate project.

Give it a name and click Create Site.

New Cloud Project from GitHub Repository#

To create a new project from a GitHub repository, first ensure all code is pushed to a repository that your user can access. Then visit the new project screen and choose Create from GitHub.

Then choose Use my repository, authenticate with GitHub, and set the appropriate options. Click the Configure button if necessary to ensure Stackbit has the appropriate access to your repository. Learn more about required GitHub permissions.

Note the following in the screenshot above:

1. The configure button can help you reset Stackbit's permissions for your GitHub account. This may be necessary if you don't see the repo in the list.
2. The list of repositories Stackbit can access via your user.
3. Stackbit automatically validates that you have a valid Stackbit configuration.
4. Advanced options allow you to set the primary branch and a root directory (for monorepo support).

Click Next to move on to the final step. In the last step, you can set your project name and working Git branch. Learn more about Git branches in Stackbit.

Learn more about creating projects from GitHub.

Duplicating a Project#

Duplicating a project follows the same process as creating from GitHub, with a few exceptions:

• Choose Duplicate repository rather than Use my repository.
• You must know the URL to the GitHub repository.

Learn more about creating projects from GitHub.