--- title: "Create a project" slug: "create-a-project" description: "Turn a folder of design files on your computer into a new Allspice project with Allspice Desktop. Set the name, owner, privacy, and branch settings." tags: ["version control", "allspice desktop"] updated: 2026-10-28T20:33:37Z published: 2026-10-28T20:33:37Z canonical: "learn.allspice.io/create-a-project" --- > ## Documentation Index > Fetch the complete documentation index at: https://learn.allspice.io/llms.txt > Use this file to discover all available pages before exploring further. # Create a project Create a project to publish a folder of design files on your computer as a new Allspice project. > **Beta:** Allspice Desktop is in beta and available only to select organizations, as of October 13, 2026. Features, supported systems and these instructions may change between releases, and some features may be incomplete. If your organization doesn't see the **Desktop App** button in Allspice Hub, it isn't part of the beta yet. Contact your Allspice account team to learn more. We welcome your feedback. ## Start a new project If you have no projects in the app yet, select **Create New Project** on the **Create your first project** screen. ![The Create your first project screen](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/03-get-started.png) If you already have projects, select **+** beside **Projects** in the sidebar. Then select **Create New Project**. ![The + menu with Create New Project and Clone Project](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/03-add-project-menu.png) ## Fill in the project details 1. In **Project folder**, select **Choose…** and pick the folder that holds your design files. 2. In **Name**, check the project name. The app fills it in from the folder name. A name can use only letters, numbers, `-`, `_`, and `.`. 3. In **Owner**, select yourself or one of your organizations. 4. Keep **Private project** selected to limit who can see the project. Clear it to make the project public. ![The Create a project from a folder screen](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/03-create-project.png) The folder must not already be a git repository. ## Change the advanced settings (optional) Select **Advanced settings** to see more options. ![The Advanced settings section](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/03-create-advanced.png) - **Description**: a short summary of the project. - **Default branch**: the name of the main branch. It starts as `main`. - **Create a develop branch to work on**: the app also creates a `develop` branch and switches to it. This option is on by default. - **Protect the default branch (changes via pull request)**: changes reach the default branch only through pull requests in Allspice. This option is on by default. ## Create the project 1. Select **Create Project**. 2. When the app opens the project, your files show as new changes. 3. Commit and push the files to upload them to Allspice. See [Work on a project](/v1/docs/work-on-a-project) ## If creating the project fails If the app stops partway, the new project may stay on Allspice with no files. Delete that project in Allspice before you use the same name again. If Allspice doesn't protect the default branch, the app still creates the project and shows no error. Check the branch settings in Allspice.