pnpm workspace root for Barazo forum development -- shared configuration, tooling, and cross-package dependency management.
This repository contains the shared workspace configuration for the Barazo forum platform. It provides pnpm workspace linking, shared dependency versions via pnpm catalogs, base TypeScript and ESLint configs, and development tooling (commitlint, husky, vitest base config). Each Barazo package lives in its own repository and is cloned into this workspace root as a subdirectory.
| Directory | Repository | Description |
|---|---|---|
barazo-api/ |
barazo-api | AppView backend (Fastify, AT Protocol) |
barazo-web/ |
barazo-web | Forum frontend (Next.js, React) |
barazo-lexicons/ |
barazo-lexicons | AT Protocol lexicon schemas + generated types |
barazo-deploy/ |
barazo-deploy | Docker Compose templates for self-hosting |
barazo-website/ |
barazo-website | Marketing + docs site (barazo.forum) |
| File | Purpose |
|---|---|
pnpm-workspace.yaml |
Workspace package list + dependency catalog |
package.json |
Shared devDependencies + workspace scripts |
tsconfig.base.json |
Base TypeScript config extended by all packages |
eslint.config.base.js |
Base ESLint config extended by all packages |
vitest.config.base.ts |
Base Vitest config with coverage thresholds |
commitlint.config.js |
Conventional commit enforcement |
.npmrc |
GitHub Packages registry + workspace linking |
Requires Node.js 24 LTS and pnpm 10.x.
# Clone the workspace root
git clone https://github.com/singi-labs/barazo-workspace.git singi-labs
cd singi-labs
# Clone each sub-project
git clone https://github.com/singi-labs/barazo-api.git
git clone https://github.com/singi-labs/barazo-web.git
git clone https://github.com/singi-labs/barazo-lexicons.git
git clone https://github.com/singi-labs/barazo-deploy.git
git clone https://github.com/singi-labs/barazo-website.git
# Install all dependencies (workspace-wide)
pnpm install
# Start development infrastructure (PostgreSQL, Valkey)
pnpm dev:infra
# Start API and web in separate terminals
pnpm dev:api
pnpm dev:webpnpm test # Run tests across all packages
pnpm lint # Lint all packages
pnpm typecheck # Type-check all packages
pnpm build # Build all packagesKey standards:
- Conventional commits enforced via commitlint + husky
- Strict TypeScript (
strict: true, noany) - All changes via Pull Requests (never commit directly to
main) - See CONTRIBUTING.md for full guidelines
| Repository | Description | License |
|---|---|---|
| barazo-api | AppView backend -- Fastify, firehose, API | AGPL-3.0 |
| barazo-web | Forum frontend -- Next.js, Tailwind | MIT |
| barazo-lexicons | Lexicon schemas + generated TypeScript types | MIT |
| barazo-deploy | Docker Compose templates for self-hosting | MIT |
| barazo-website | Marketing + docs site (barazo.forum) | MIT |
| .github | Org-level community health files | MIT |
- Website: barazo.forum
- Discussions: GitHub Discussions
- Issues: Report bugs
MIT -- Workspace configuration and shared tooling are permissively licensed to allow maximum reuse.
See LICENSE for full terms.
Made with ♥ in 🇪🇺 by Singi Labs