Your first project
A project in Almirant is the main container for all your work. Inside a project you'll find boards, work items, documents, sprints, and integration settings.
What is a project
Think of a project as the dedicated space for a specific product, service, or initiative. Each project has:
- Boards -- Kanban boards to visualize the workflow
- Work Items -- Tasks organized hierarchically (Epic > Feature > Story > Task)
- Sprints -- Iterations with dates and objectives
- Documents -- Notes and relevant links for the project
- Settings -- Tech stack, repositories, and associated URLs
Create a project
1. Access the project list
From the dashboard, click on Projects in the sidebar or on the New project button.
2. Fill in the basic details
In the creation form, enter:
| Field | Description | Example |
|---|---|---|
| Name | Identifying name for the project | "Mobile App v2" |
| Description | Brief description of the project's objective | "Complete redesign of the mobile app with React Native" |
| Color | Color to visually identify the project | Blue, green, red, etc. |
3. Confirm the creation
Click Create project. You will be redirected to the view of the newly created project.
Configure the project
Once created, it's recommended to complete the project configuration. This is especially useful if you plan to connect the AI via MCP, as the project context helps the AI better understand your stack and codebase.
Project information
Access the project settings from the gear icon or the Settings section within the project. Here you can define:
| Field | Purpose | Example |
|---|---|---|
| Tech Stack | Technologies used in the project | "Next.js, TypeScript, PostgreSQL" |
| URLs | Relevant links (production, staging, docs) | "https://app.mycompany.com" |
| Repositories | Associated code repositories | Direct connection with GitHub |
You can connect GitHub repositories directly to your project. This allows the AI to access the code context and create pull requests automatically. See the GitHub integrations section for more details.
Project view
After creating and configuring your project, the main view shows:
- Summary -- General overview of the project status
- Boards -- List of associated boards
- Work Items -- All project tasks with filters
- Sprints -- Planning by iterations
- Documents -- Notes and project resources
Each project has a unique prefix (for example, APP, WEB) that is used to generate work item identifiers (like APP-T-1, APP-S-5). This prefix is assigned automatically but you can customize it.
What's next
With your project created, the next step is to create a board to organize your work visually.
Next step: Your first board and work items -- Create a Kanban board and add your first tasks.