Create Project

You can create a new GitScrum project without leaving your code editor. The extension walks you through a quick two-step flow — pick a workspace, name your project — and opens the Kanban board automatically so you can start working.

The Problem This Solves

Creating a project usually means opening the browser, navigating to your workspace, filling in forms, and then returning to your editor. This interrupts your workflow when you are setting up a quick prototype, a side project, or a new microservice that needs its own task board right away.

The Create Project command keeps you in the editor. Two inputs, one click, and you have a fully configured project ready for task management.

What You Are Looking At

The creation flow uses native VS Code QuickPick menus — no webview, no browser. You see:

1. A workspace picker listing every workspace where you have permission to create projects
2. A text input for the project name
3. The project's Kanban board opens automatically after creation

How to Create a Project

Step 1: Start the Flow

Use either method:

• Click the + button in the Explorer sidebar header
• Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and run GitScrum: Create Project

Step 2: Select a Workspace

A dropdown appears listing your available workspaces. Only workspaces where you have project creation permissions are shown.

Select the workspace where the new project should live.

Step 3: Name Your Project

A text input appears. Type the project name and press Enter.

• The name is required (cannot be empty)
• It can contain letters, numbers, spaces, and special characters
• GitScrum generates a URL slug automatically from the name

Step 4: Start Working

After creation:

1. The Explorer sidebar refreshes to include the new project
2. The Kanban board opens automatically in a new editor tab
3. The board includes default workflow columns ready for task creation

You can immediately start creating tasks on the board.

What Gets Created

When you create a project through the extension, GitScrum sets up:

• The project with the name you provided
• Default workflow columns (the standard Kanban stages)
• The project tree in the Explorer sidebar with all feature sections (Plan, Build, Knowledge)

The project is private by default. You can adjust visibility, add team members, and configure advanced settings from the GitScrum web application.

Pro Tips (Once You Are Comfortable)

• Quick experiments: Use Create Project for quick experiment boards. Need to track tasks for a proof-of-concept? Create a project in seconds and start dragging cards.

• After creation: Open the Board, create a few tasks, and start the status bar timer right away. Full workflow from project creation to time tracking without leaving the editor.

• Workspace selection: If you only belong to one workspace with creation permissions, the picker still shows it for confirmation. Select it and continue.

Permissions

Project creation requires specific workspace permissions:

• Agency Owners: Can create projects in any workspace they own
• Members with creation rights: Can create projects in workspaces where this permission has been granted

If no workspaces appear in the picker, you do not have project creation permissions in any workspace. Contact your workspace owner.

How to Report a Problem or Request a Feature

If project creation fails or you have suggestions for the creation flow, submit feedback through GitScrum Studio.

In the Sidebar of the web application, click on Support Tickets and open a ticket describing your experience.