> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vibehub.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Projects

> Learn how to create new projects in VibeHub

## Overview

Projects are the foundation of VibeHub. Every piece of code you track lives within a project.

## Create a New Project

<Steps>
  <Step title="Open the Dashboard">
    Navigate to your [VibeHub dashboard](https://vibehub.co.in) after signing in
  </Step>

  <Step title="Click New Project">
    Click the **New Project** button in the top right corner of your dashboard
  </Step>

  <Step title="Enter Project Details">
    Fill in the required information:

    * **Project Name**: A unique name for your project (e.g., `my-awesome-app`)
    * **Description**: An optional description of what you're building
  </Step>

  <Step title="Create">
    Click **Create Project** to finish. You'll be taken to your new project's page.
  </Step>
</Steps>

## Project Naming Guidelines

<Tip>
  Choose a clear, descriptive name that reflects what your project does. Good names are lowercase with hyphens (e.g., `user-auth-service`, `landing-page`).
</Tip>

### Naming Rules

* Must be unique within your account
* Can contain letters, numbers, and hyphens
* Cannot start or end with a hyphen
* Maximum 100 characters

## What Happens When You Create a Project?

When you create a new project, VibeHub:

1. Creates an empty project container
2. Sets up a default `main` branch
3. Makes you the project owner
4. Generates a unique project URL

Your project URL will be: `https://vibehub.co.in/your-username/project-name`

## After Creating Your Project

Once your project is created, you have several options:

<CardGroup cols={2}>
  <Card title="Push Code via CLI" icon="terminal" href="/cli/commands/push">
    Use the VibeHub CLI to push your local code
  </Card>

  <Card title="Import from GitHub" icon="github" href="/projects/importing-from-github">
    Import an existing GitHub repository
  </Card>

  <Card title="Invite Collaborators" icon="user-plus" href="/collaboration/inviting-collaborators">
    Add team members to your project
  </Card>

  <Card title="Configure Settings" icon="gear" href="/projects/project-settings">
    Set visibility and other options
  </Card>
</CardGroup>

## Project Visibility

By default, new projects are **private**. You can change this in project settings to make your project public.

| Visibility  | Who Can View       | Who Can Push                    |
| ----------- | ------------------ | ------------------------------- |
| **Private** | Only collaborators | Collaborators with write access |
| **Public**  | Anyone             | Collaborators with write access |

<Note>
  Even public projects require collaborator access to push changes. Public visibility only affects viewing.
</Note>