gui.do / barazo-workspace
pnpm workspace root for Barazo forum development — shared configuration, tooling, and cross-package dependency management barazo.forum
fork atom
JavaScript 57.8%
Shell 24.1%
TypeScript 15.5%
Other 2.5%
51 1 0

Clone this repository

https://tangled.org/gui.do/barazo-workspace https://tangled.org/did:plc:45uheisi25szrjvjurfpritx/barazo-workspace
git@knot.tangled.wizardry.systems:gui.do/barazo-workspace git@knot.tangled.wizardry.systems:did:plc:45uheisi25szrjvjurfpritx/barazo-workspace

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md
Barazo Logo

Barazo Workspace#

pnpm workspace root for Barazo forum development -- shared configuration, tooling, and cross-package dependency management.

Status: Alpha License: MIT Node.js TypeScript

Overview#

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.

Workspace Structure#

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)

Shared Configuration#

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

Quick Start#

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:web

Development#

pnpm test        # Run tests across all packages
pnpm lint        # Lint all packages
pnpm typecheck   # Type-check all packages
pnpm build       # Build all packages

Key standards:

  • Conventional commits enforced via commitlint + husky
  • Strict TypeScript (strict: true, no any)
  • 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

Community#

License#

MIT -- Workspace configuration and shared tooling are permissively licensed to allow maximum reuse.

See LICENSE for full terms.

(c) 2026 Barazo