Getting Started
Local development setup, prerequisites, environment variables, and first run instructions.
Frontend Overview
Honeycomb is a full-stack SvelteKit application that serves as the primary interface for the platform. It combines server-side rendering with rich client-side interactivity, backed by Supabase for authentication, database access, and realtime features. The frontend is deployed to Cloudflare Pages and uses Stripe for billing, AI provider APIs for intelligent features, and a modern component library built on shadcn/svelte.
Tech Stack
Section titled “Tech Stack”| Layer | Technology | Version |
|---|---|---|
| Framework | SvelteKit | 2.50 |
| UI Library | Svelte (runes) | 5 |
| Language | TypeScript | 5.x |
| Auth & Database | Supabase | latest |
| Styling | Tailwind CSS | 4 |
| Component Library | shadcn/svelte + bits-ui | latest |
| Forms | sveltekit-superforms + Zod | v4 (Zod) |
| Payments | Stripe | latest |
| Charts | LayerChart + D3 | latest |
| Tables | TanStack Table | latest |
| Deployment | Cloudflare Pages | — |
Documentation Sections
Section titled “Documentation Sections”Architecture
High-level project structure, module boundaries, data flow patterns, and design decisions.
Modules
Feature modules such as contracts, clients, invoices, projects, and their internal organization.
Extensions
Plugin and extension points for adding new functionality to the platform.
Routing
SvelteKit file-based routing conventions, route groups, layout hierarchy, and param matchers.
Pages
Page-level components, load functions, server vs. universal loading, and page data contracts.
Components
Reusable UI components, shadcn/svelte primitives, compound components, and component patterns.
Data Layer
Supabase client setup, database queries, realtime subscriptions, and RPC calls.
State Management
Svelte 5 runes, stores, context-based state, and reactive patterns used across the app.
Forms & Validation
sveltekit-superforms integration, Zod schemas, server-side validation, and progressive enhancement.
Authentication
Supabase Auth flow, session handling, route guards, and role-based access control.
Styling
Tailwind CSS v4 configuration, design tokens, dark mode, and component styling conventions.
Integrations
Third-party service integrations including Stripe, OpenAI, Anthropic, Giphy, and more.
Apps
Sub-application boundaries within the monolith, including the main app, marketing site, and admin.
Utilities
Shared helper functions, formatters, type utilities, and common patterns.
Deployment
Cloudflare Pages deployment pipeline, Wrangler configuration, environment bindings, and CI/CD.