Introduction

Welcome to Cosella

Cosella is a live objection-handling AI assistant for B2B sales teams. Reps upload a playbook once, and every rep gets the right answer on the call, pulled from their knowledge base. This documentation covers everything you need to know to get started.

Quick Start

• Installation - Set up your development environment
• Project Structure - Understand the monorepo layout
• Engineering Overview - Technical architecture

Applications

App	Description	Stack
Dashboard	Rep-facing sales dashboard with 15 feature slices	React + Vite + TanStack Router
Admin	Internal admin panel with 15 feature slices	React + Vite + TanStack Router
Desktop	Electron desktop copilot for live sales calls	Electron + React + Vite
Docs	This documentation site	Astro + Starlight
Marketing	Public landing page and waitlist	Astro + React
Storybook	Component development and visual testing	Storybook 9 + Vite

Tech Stack

Category	Technology
Framework	React 19.1.0 + TypeScript 5.9.2
Build Tool	Vite 6.3.5 + Turborepo 2.5.4
Styling	Tailwind CSS v4.1.8 + Radix UI
State Management	Zustand 5.0.5 + TanStack Query 5.80.7
Routing	TanStack Router 1.121.12
Forms	React Hook Form 7.57.0 + Zod 3.25.67
Testing	Vitest 3.2.4 + Playwright 1.52.0
Package Manager	pnpm 9.15.9

Design System

Cosella uses a custom design system built on:

• Tokens: CSS-first design tokens using Tailwind v4 @theme {} blocks
• Components: 25+ Radix UI primitives with consistent styling
• Patterns: Feature-slice architecture with capability-based gating

Learn more about the Design Tokens and UI Components.

Contributing

• Development Guide - Contribution workflow
• Vibecoder UI Guide - Safe UI-only contributions for vibecoders
• AI Agent Guide - Rules for AI coding agents (Claude, Copilot, Cursor, etc.)