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.
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.):
- Create a demo site and click around to get an initial feel for Stackbit.
- Talk with an expert to learn more about Stackbit and ask specific questions.
- Learn the basics by following the tutorial and reading core concepts.
- Create a new local project or immediately begin integrating Stackbit into their site (also by working locally).
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.
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.
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-appto 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.
Below are a number of scenarios that each explain a specific mode for starting a new project.
When you want to start a new project locally from scratch, use the
If you already have a project and want to integrate Stackbit, refer to our framework integration guides.
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.
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:
- 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.
- The list of repositories Stackbit can access via your user.
- Stackbit automatically validates that you have a valid Stackbit configuration.
- 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.
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.