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.

Full website demo

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.

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

If you already have a project and want to integrate Stackbit, refer to our framework integration guides.

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.

New project dashboard

Give it a name and click Create Site.

New project name

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.

Click create from GitHub button

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.

Choose and configure GitHub repo

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.

Configure Git branches

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.

Duplicate repository

Learn more about creating projects from GitHub.