How asterisksinc/boq-saas works
BOQ SaaS is a web application for managing construction projects, bills of quantities, costs, templates, and related business operations. The visible user workflow runs from dashboard screens through client API helpers to a versioned server API backed by Supabase. Other substantial product areas include activity tracking, billing, support, settings, and integrations. The README provides no feature detail, so capability coverage is based mainly on the source tree and SOURCE INDEX; several subsystem links remain unverified because their implementation was not sampled.
Main entry points: route.ts Versioned API · auth.ts Client API helpers · boqs/page.tsx Bills of quantities · costs/page.tsx Cost workspace
Components 22
BOQ and costing
- Bills of quantities
app/boqs/page.tsx - Cost analysis
app/costs/components/AnalysisTab.tsx - Cost workspace
app/costs/page.tsx - Templates
app/templates/page.tsx
API and data
- Client API helpers
lib/api/auth.ts - Versioned API
app/api/v1/[...path]/route.ts - Supabase server client
lib/supabase/server.ts - Costing API
lib/api/costing.ts - Template API
lib/api/templates.ts - Settings adapter
lib/settings/adapter.ts
Workspace features
- Activities
app/activities/page.tsx - Documents
app/documents/page.tsx - Proposals
app/proposals/page.tsx - Invoices
app/invoices/page.tsx - Billing
app/billing/page.tsx - Help and support
app/help/page.tsx - Integrations
app/integrations/page.tsx
Organization controls
- Settings
app/settings/page.tsx - Administration
app/admin/page.tsx
Other components
- Workspace user
Connections 22
- Workspace user → Dashboard: opens
- Workspace user → Projects: manages
- Workspace user → Bills of quantities: creates
app/boqs/page.tsx - Dashboard → Client API helpers: loads account data
app/dashboard/page.tsx - Activities → Client API helpers: loads and updates tasks
app/activities/page.tsx - Help and support → Client API helpers: loads help content
app/help/page.tsx - Settings → Client API helpers: updates profile
app/settings/page.tsx - Billing → Client API helpers: loads billing data
app/billing/page.tsx - Cost workspace → Cost analysis: renders analysis
app/costs/page.tsx - Cost workspace → Costing API: loads costing data
app/costs/page.tsx - Cost analysis → Costing API: requests costing data
app/costs/components/AnalysisTab.tsx - Templates → Template API: loads templates
app/templates/page.tsx - Client API helpers → Versioned API: calls versioned endpoints
lib/api/auth.ts - Versioned API → Supabase server client: creates server client
app/api/v1/[...path]/route.ts - Versioned API → Settings adapter: uses settings adapter
app/api/v1/[...path]/route.ts - Versioned API → Administration: serves admin operations
- Projects → Bills of quantities: associates project BOQs
- Templates → Bills of quantities: provides BOQ templates
- Documents → Versioned API: uses document endpoints
- Proposals → Versioned API: uses proposal endpoints
- Invoices → Versioned API: uses invoice endpoints
- Integrations → Versioned API: uses integration endpoints