q9stack

q9stack is an open-source TypeScript toolkit and project generator for shared development tooling and application scaffolds.

It exists to make reusable tooling and starter defaults easier to maintain in one place, so projects can adopt improvements without copying shared code. Application-specific domain logic stays in each project.

Quickstart

pnpm create q9stack

Follow the prompts to choose a project name and stack.

Packages

• create-q9stack — scaffold a project from the q9stack templates.
• gates — plan and run quality checks with the q9gate CLI.
• diagnostics — safe diagnostic code, event, and trace-brief contracts.
• diagnostics-server — Node/Effect tracing, redaction, and Postgres lookup.
• cli — project-local agent commands, including q9 diag.
• config-depcruise — reusable dependency-boundary rules.
• config-oxlint — shared Oxlint and Oxfmt configuration.
• config-semgrep — reusable Semgrep rule packs.
• config-tsconfig — strict TypeScript base configurations.
• env — typed environment parsing for Node, Workers, and Vite.
• ui — design tokens, UI primitives, app shell, and theming.
• ai — Effect-wrapped AI model and workflow primitives.
• voice — provider-neutral browser voice-call clients.

Project guides

• Theory — scope, sharing model, and design decisions.
• Glossary — project terminology.
• Contributing — propose recipes, report bugs, and run the gate.
• Convex diagnostics recipe and command adapter recipe — product-owned trace capture and retrieval.