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

# Introduction to 8Space

> Open source team planning tool with Backlog, Kanban, Timeline, and Dashboard views for collaborative project management

## What is 8Space?

8Space is an open source team planning and project management tool that combines multiple views and workflows into a unified platform. Built with React, Next.js, and Supabase, it provides everything you need to plan, track, and ship your projects efficiently.

<Info>
  8Space is designed for teams that need flexibility in how they visualize and manage work, from agile sprints to long-term project timelines.
</Info>

## Key features

8Space offers a comprehensive set of features for modern project management:

<CardGroup cols={2}>
  <Card title="Backlog management" icon="list-check">
    Organize and prioritize tasks in a dedicated backlog view with drag-and-drop support and task ranking.
  </Card>

  <Card title="Kanban boards" icon="columns-3">
    Visualize work-in-progress across customizable workflow columns (Backlog, To Do, In Progress, Done) with WIP limits.
  </Card>

  <Card title="Timeline view" icon="chart-gantt">
    Plan project schedules with interactive Gantt charts, task dependencies, and milestone tracking.
  </Card>

  <Card title="Dashboard analytics" icon="chart-line">
    Monitor project health with real-time metrics including task distribution, overdue counts, and completion trends.
  </Card>

  <Card title="Multi-tenant workspaces" icon="building">
    Organize work into separate tenants with dedicated projects and team members.
  </Card>

  <Card title="Role-based access" icon="shield-halved">
    Control permissions with granular roles: owner, admin, editor, and viewer at both tenant and project levels.
  </Card>
</CardGroup>

## Architecture overview

8Space is built as a monorepo with two main packages:

```
8space-monorepo/
├── packages/
│   ├── landing/          # Marketing site (Next.js)
│   └── app/              # Main application (React + Vite + Supabase)
├── docs/                 # Documentation and OpenAPI spec
└── scripts/              # Development orchestration
```

### Technology stack

<AccordionGroup>
  <Accordion title="Frontend" icon="react">
    * **React 19** with React Router for navigation
    * **Vite** for fast development and optimized builds
    * **TanStack Query** for server state management
    * **Radix UI** components for accessible UI primitives
    * **Tailwind CSS** for styling with dark mode support
    * **dnd-kit** for drag-and-drop functionality
  </Accordion>

  <Accordion title="Backend" icon="database">
    * **Supabase** for backend-as-a-service
    * **PostgreSQL** database with Row Level Security (RLS)
    * **Supabase Auth** for authentication (email, Google OAuth)
    * **Real-time subscriptions** for collaborative features
  </Accordion>

  <Accordion title="Landing page" icon="globe">
    * **Next.js 15** with App Router
    * **API routes** for lead capture and billing
    * **Stripe** integration for payments (optional)
    * **Resend** for transactional emails (optional)
  </Accordion>
</AccordionGroup>

## Database schema highlights

The database schema supports multi-tenancy and collaborative project management:

* **Tenants**: Top-level organization containers
* **Projects**: Isolated workspaces within tenants
* **Tasks**: Core work items with rich metadata (priority, dates, estimates)
* **Workflow columns**: Customizable status columns with configurable kinds
* **Project members**: Role-based access control per project
* **Task dependencies**: FS (Finish-to-Start) relationships for scheduling
* **Activity log**: Audit trail for all task changes

<Note>
  All tables use Row Level Security (RLS) policies to ensure users can only access data they have permission to view.
</Note>

## Development workflow

8Space uses a unified development workflow with all services running together:

```bash theme={null}
npm run dev
```

This single command starts:

* Landing page on `http://localhost:3000`
* App on `http://localhost:5173/app/`
* Swagger UI on an auto-selected port

See the [Installation](/installation) guide for detailed setup instructions.

## Project roles and permissions

8Space implements a two-level permission system:

### Tenant-level roles

| Role       | Permissions                                                  |
| ---------- | ------------------------------------------------------------ |
| **Owner**  | Full control over tenant settings, members, and all projects |
| **Admin**  | Manage projects and members, cannot delete tenant            |
| **Member** | Access assigned projects, limited tenant visibility          |

### Project-level roles

| Role       | Permissions                                       |
| ---------- | ------------------------------------------------- |
| **Owner**  | Full project control, manage members and columns  |
| **Editor** | Create, update, and delete tasks and dependencies |
| **Viewer** | Read-only access to project data                  |

<Warning>
  Project members inherit access from tenant membership. Users must be tenant members before they can be added to projects.
</Warning>

## Use cases

8Space is ideal for:

* **Software development teams** managing sprints and releases
* **Product teams** planning roadmaps and feature backlogs
* **Project managers** tracking dependencies and critical paths
* **Agencies** managing client projects with separate workspaces
* **Open source projects** coordinating contributors and milestones

## Getting started

Ready to run 8Space locally? Follow these guides:

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Get 8Space running in under 5 minutes with the express setup guide.
  </Card>

  <Card title="Installation" icon="download" href="/installation">
    Detailed installation instructions for local development and production deployment.
  </Card>

  <Card title="Configuration" icon="gear" href="/configuration/environment-variables">
    Configure environment variables, authentication, and optional services.
  </Card>

  <Card title="API Reference" icon="code" href="/api/overview">
    Explore the API endpoints and integration options.
  </Card>
</CardGroup>

## Open source and contributions

8Space is open source software released under the MIT license. We welcome contributions from the community.

* **Repository**: [github.com/AndreyMishurin/8Space](https://github.com/AndreyMishurin/8Space)
* **Issues**: Report bugs and request features on GitHub
* **Security**: See [SECURITY.md](https://github.com/AndreyMishurin/8Space/blob/main/SECURITY.md) for vulnerability disclosure

<Tip>
  Star the repository on GitHub to stay updated with the latest releases and features.
</Tip>