Danvas
Danvas
DashboardSupportWelcome

👤 USER DOCS

User Guides

Getting Started

Getting StartedDashboard & OnboardingApp Settings

Tutorials

Tutorial: Setting Up Shift Tasks & ClosersTutorial: Managing Incidents in the InboxTutorial: Tracking Compliance & Sync StatusTutorial: Operational Workflows with the AI AssistantTutorial: Building & Deploying Custom Checklists

Daily Operations (Staff)

Shift Workspace & TasksService Day SetupDaily Line-UpStaff Service Day ReportsForms

Communication & Chat

Messages & AnnouncementsUnified Operations InboxAI Assistant

Manager & Admin Guides

Daily Line-Up SetupStaff SchedulingManaging LocationsNPS and Guest FeedbackCouponsContacts and Guest HistoryManager CloseoutsDaily Line-Up & ComplianceAnalyticsIncident ReportingWhistleblower Concerns & FeedbackAdmin Tools

⚙️ DEVELOPER DOCS

Getting Started

Getting StartedDevelopmentDeployment Guide

Architecture

Architecture OverviewExplanation: AI Integration & Tenant SecurityExplanation: Dynamic Forms Engine DesignExplanation: Compliance Ledger DesignExplanation: Live Sync & Data FreshnessData FlowArchitecture Decision Records

Core Domain

Core DomainDatabase ReferenceLocations DomainAuth & RBACScheduling DomainReports DomainIncidents DomainUnified Operations InboxLive Sync Data FreshnessToast Sync PipelineNotifications DomainCoupons and Guest NPSAudit Log & Compliance ArchitectureDesign Audit FindingsAI Chat IntegrationAnalytics & Tips Integration

Frontend

Frontend ArchitectureFormsLoading SkeletonsComponentsPWA & Offline ShellScreenshots

API Reference

API Reference

Endpoints

POS Sales APIOptimization Data APISchedule Shifts APIEmployee Export APIReports APIIncidents APIAI Chat APIPush Notifications APIWebhooks APICron API

Contributing

ContributingCode Examples

Security

Security & Compliance

Release Notes

What's New

Getting Started

Set up Danvas for local development in minutes

Overview

Danvas is a Bun/Turborepo monorepo. This guide covers the shortest supported path to a local development environment; SETUP.md is the complete environment reference.

Prerequisites

  • Node.js 24.x
  • Bun 1.4.0
  • Git
  • Development credentials for Clerk, Neon, and the Vercel AI Gateway

Quickstart

  1. Clone the repository and enter the repository directory:

    git clone https://github.com/canvasforms/danvas-forge.git
cd danvas-forge

  2. Install dependencies and generate environment files:

    bun install
bun setup

  3. Fill the required values in the generated .env files. See SETUP.md and docs/reference/environment-variables.md.

  4. Apply the reviewed development migrations:

    bun db:migrate

  5. Start the main app and API:

    bun run dev

Local services:

ServiceURL
Main apphttp://localhost:4000
API healthhttp://localhost:4002/health
Guest apphttp://localhost:3300
Slack bothttp://localhost:4005
Docshttp://localhost:4004
Analytics MCPhttp://localhost:4006
Storybookhttp://localhost:6006

Use bun run dev:all when you need the complete local suite.

Database safety

Normal schema changes use bun db:generate followed by bun db:migrate. bun db:push:local is reserved for intentional local-only diagnostics. Never use a direct schema push as the production migration workflow; production uses the approval-gated runner.

Next steps

  • Architecture overview
  • Development workflow
  • Database reference
  • Deployment
  • Contributing guide

Admin Tools

User roster management, role permissions, and roster integrations

Development

Local development guide for Danvas

On this page

OverviewPrerequisitesQuickstartDatabase safetyNext steps