No description

TypeScript 49.4%
PLpgSQL 42.5%
CSS 4.5%
JavaScript 3.6%

Find a file

Clint Chapman df97cc8abc Add service address API endpoints		2026-05-26 16:19:34 -05:00
apps	Add service address API endpoints	2026-05-26 16:19:34 -05:00
docs	first commit	2026-05-26 14:46:27 -05:00
packages	Add Phase 1 database migration	2026-05-26 15:53:35 -05:00
.env.example	Add monorepo workspace foundation	2026-05-26 15:53:10 -05:00
.gitignore	Add monorepo workspace foundation	2026-05-26 15:53:10 -05:00
docker-compose.yml	Add monorepo workspace foundation	2026-05-26 15:53:10 -05:00
package-lock.json	Add company bootstrap API	2026-05-26 15:59:11 -05:00
package.json	Add monorepo workspace foundation	2026-05-26 15:53:10 -05:00
README.md	Document local development setup	2026-05-26 15:53:41 -05:00
tsconfig.base.json	Add monorepo workspace foundation	2026-05-26 15:53:10 -05:00

README.md

DuctOS

DuctOS is an all-in-one field service management ERP for HVAC and geothermal contractors.

The current repository contains:

Architecture and delivery documents in docs.
A Phase 1 monorepo scaffold for API, web, mobile, shared contracts, and database migrations.
Local Docker services for PostgreSQL/PostGIS and Redis.

Workspace Layout

apps/api        NestJS API foundation
apps/web        Next.js office app foundation
apps/mobile     Expo/React Native field app foundation
packages/shared Shared TypeScript contracts
packages/db     SQL migrations and migration runner
docs            TSD and phased development plan

Local Setup

npm install
cp .env.example .env
docker compose up -d postgres redis
npm run db:migrate
npm run dev:api
npm run dev:web

Mobile app:

npm run dev:mobile

Phase 1 Focus

Phase 1 builds the foundation, core CRM, equipment asset lifecycle, invoices, payments, outbox events, audit, and QuickBooks sync queue. The implementation plan is in Phase 1 Development Plan.