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

# Cloud overview

> Multi-tenant SaaS backend with web UI, team management, and push notifications.

The cloud component is a Next.js 16 application that provides the multi-tenant backend and web interface for OpenBunny. It's backed by Supabase PostgreSQL with Row Level Security for data isolation.

## What it provides

* **Web dashboard** — Kanban board, task detail, calendar, and timeline views
* **Team management** — create teams, invite members, assign roles
* **API token authentication** — PAK tokens for service-to-cloud communication
* **Push notifications** — APNs (iOS), FCM (Android), and Web Push
* **Gmail integration** — OAuth flow and webhook handling
* **SSE event bridge** — real-time event delivery to the service

## Tech stack

| Component     | Technology                     |
| ------------- | ------------------------------ |
| Framework     | Next.js 16 (App Router)        |
| Frontend      | React 19                       |
| Styling       | Tailwind CSS 4                 |
| Database      | Supabase PostgreSQL            |
| Auth          | Supabase Auth (magic link OTP) |
| Drag-and-drop | @hello-pangea/dnd              |
| Calendar      | FullCalendar                   |

## Web UI pages

| Page           | Path               | Description                       |
| -------------- | ------------------ | --------------------------------- |
| Dashboard      | `/dashboard`       | Kanban board with 5 columns       |
| Task detail    | `/tasks/[id]`      | Full task view with comments      |
| New task       | `/tasks/new`       | Task creation form                |
| Contacts       | `/contacts`        | Contact list with search          |
| Contact detail | `/contacts/[slug]` | Contact profile with identities   |
| Settings       | `/settings`        | Profile, team members, API tokens |
| Email settings | `/settings/email`  | Gmail connection management       |
| Calendar       | `/calendar`        | Calendar view of reminders        |
| Timeline       | `/timeline`        | Activity timeline                 |

## Project structure

```
cloud/
├── src/
│   ├── app/
│   │   ├── (app)/              # Authenticated routes
│   │   │   ├── dashboard/      # Kanban board
│   │   │   ├── tasks/          # Task views
│   │   │   ├── contacts/       # Contact views
│   │   │   ├── settings/       # Settings & tokens
│   │   │   ├── calendar/       # Calendar view
│   │   │   └── timeline/       # Activity timeline
│   │   ├── api/                # REST API routes
│   │   ├── login/              # Magic link login
│   │   └── auth/               # OAuth callbacks
│   ├── components/             # React components
│   ├── lib/                    # Auth, Supabase clients, types
│   └── middleware.ts           # Auth guard
├── supabase/
│   └── migrations/             # SQL migrations (001-018)
└── package.json
```