Quick Start

Install and run

git clone https://github.com/your-org/clave.git
cd clave
bun install
cp .env.example .env.local
# Fill in your Convex and Google OAuth credentials
bun run dev

Open http://localhost:4000 and sign in.

Create a workspace

After signing in, you'll be prompted to create your first workspace. Choose a name (e.g., "My Team") and a URL slug (e.g., my-team).

Create your first project

1. Click Projects in the sidebar
2. Click New Project
3. Give it a name, pick an icon and color
4. Your project is ready — it includes a board, timeline, and card views

Create issues

Issues are the primary work items in Clave. Create them from the project board:

1. Open your project
2. Switch to Board view
3. Click + New Issue in any column
4. Add a title, description, assignee, and priority

Write a document

Documents are rich-text pages for specs, notes, and meeting minutes:

1. Click Docs in the sidebar
2. Click New Document
3. Start writing — the editor supports headings, lists, code blocks, embeds, and more
4. Share with your team — changes sync in real-time

Use the whiteboard

Whiteboards are freeform canvases for brainstorming:

1. Click Boards in the sidebar
2. Click New Board
3. Use the toolbar to add shapes, sticky notes, text, and drawings

Key shortcuts

Speed up your workflow with keyboard shortcuts:

Shortcut	Action
Cmd+K	Command palette
Cmd+B	Toggle sidebar
C	Create new issue
?	Shortcuts menu
G then P	Go to Projects
G then I	Go to Inbox

Press ? anywhere to see the full shortcuts list.

Next steps

• Getting Started — full setup guide with troubleshooting
• Keyboard Shortcuts — complete shortcuts reference
• Architecture — how Clave is built under the hood