gui.do
pnpm workspace root for Barazo forum development — shared configuration, tooling, and cross-package dependency management
barazo.forum
chore: rename barazo-forum to singi-labs across all files
+1
-1
.github/workflows/dependency-freshness.yml
+1
-1
.github/workflows/dependency-freshness.yml
+1
-1
.github/workflows/deploy-staging.yml
+1
-1
.github/workflows/deploy-staging.yml
+2
-2
.github/workflows/sync-agents-md.yml
+2
-2
.github/workflows/sync-agents-md.yml
···
32
- name: Checkout target repo
33
uses: actions/checkout@v4
34
with:
35
-
repository: barazo-forum/${{ matrix.repo }}
36
token: ${{ secrets.SYNC_TOKEN }}
37
path: target-repo
38
···
64
git push -u origin "$BRANCH"
65
PR_URL=$(gh pr create \
66
--title "docs: sync AGENTS.md from barazo-workspace" \
67
-
--body "Auto-generated from [barazo-workspace/agents-md](https://github.com/barazo-forum/barazo-workspace/tree/main/agents-md). Do not edit AGENTS.md directly in this repo." \
68
--head "$BRANCH" \
69
--base main)
70
···
32
- name: Checkout target repo
33
uses: actions/checkout@v4
34
with:
35
+
repository: singi-labs/${{ matrix.repo }}
36
token: ${{ secrets.SYNC_TOKEN }}
37
path: target-repo
38
···
64
git push -u origin "$BRANCH"
65
PR_URL=$(gh pr create \
66
--title "docs: sync AGENTS.md from barazo-workspace" \
67
+
--body "Auto-generated from [barazo-workspace/agents-md](https://github.com/singi-labs/barazo-workspace/tree/main/agents-md). Do not edit AGENTS.md directly in this repo." \
68
--head "$BRANCH" \
69
--base main)
70
+2
-2
.github/workflows/sync-lockfile.yml
+2
-2
.github/workflows/sync-lockfile.yml
···
52
run: |
53
for pkg in barazo-api barazo-web barazo-lexicons; do
54
mkdir -p "$pkg"
55
-
curl -sfL "https://raw.githubusercontent.com/barazo-forum/$pkg/main/package.json" \
56
-o "$pkg/package.json"
57
done
58
···
90
uses: peter-evans/repository-dispatch@28959ce8df70de7be546dd1250a005dd32156697 # v4.0.1
91
with:
92
token: ${{ secrets.DEPLOY_PAT }}
93
-
repository: barazo-forum/barazo-deploy
94
event-type: deploy-staging
95
client-payload: |
96
{
···
52
run: |
53
for pkg in barazo-api barazo-web barazo-lexicons; do
54
mkdir -p "$pkg"
55
+
curl -sfL "https://raw.githubusercontent.com/singi-labs/$pkg/main/package.json" \
56
-o "$pkg/package.json"
57
done
58
···
90
uses: peter-evans/repository-dispatch@28959ce8df70de7be546dd1250a005dd32156697 # v4.0.1
91
with:
92
token: ${{ secrets.DEPLOY_PAT }}
93
+
repository: singi-labs/barazo-deploy
94
event-type: deploy-staging
95
client-payload: |
96
{
+1
-1
.npmrc
+1
-1
.npmrc
+24
-24
README.md
+24
-24
README.md
···
1
<div align="center">
2
3
<picture>
4
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/barazo-forum/.github/main/assets/logo-dark.svg">
5
-
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/barazo-forum/.github/main/assets/logo-light.svg">
6
-
<img alt="Barazo Logo" src="https://raw.githubusercontent.com/barazo-forum/.github/main/assets/logo-dark.svg" width="120">
7
</picture>
8
9
# Barazo Workspace
···
29
30
| Directory | Repository | Description |
31
|-----------|-----------|-------------|
32
-
| `barazo-api/` | [barazo-api](https://github.com/barazo-forum/barazo-api) | AppView backend (Fastify, AT Protocol) |
33
-
| `barazo-web/` | [barazo-web](https://github.com/barazo-forum/barazo-web) | Forum frontend (Next.js, React) |
34
-
| `barazo-lexicons/` | [barazo-lexicons](https://github.com/barazo-forum/barazo-lexicons) | AT Protocol lexicon schemas + generated types |
35
-
| `barazo-deploy/` | [barazo-deploy](https://github.com/barazo-forum/barazo-deploy) | Docker Compose templates for self-hosting |
36
-
| `barazo-website/` | [barazo-website](https://github.com/barazo-forum/barazo-website) | Marketing + docs site (barazo.forum) |
37
38
## Shared Configuration
39
···
55
56
```bash
57
# Clone the workspace root
58
-
git clone https://github.com/barazo-forum/barazo-workspace.git barazo-forum
59
-
cd barazo-forum
60
61
# Clone each sub-project
62
-
git clone https://github.com/barazo-forum/barazo-api.git
63
-
git clone https://github.com/barazo-forum/barazo-web.git
64
-
git clone https://github.com/barazo-forum/barazo-lexicons.git
65
-
git clone https://github.com/barazo-forum/barazo-deploy.git
66
-
git clone https://github.com/barazo-forum/barazo-website.git
67
68
# Install all dependencies (workspace-wide)
69
pnpm install
···
92
- Conventional commits enforced via commitlint + husky
93
- Strict TypeScript (`strict: true`, no `any`)
94
- All changes via Pull Requests (never commit directly to `main`)
95
-
- See [CONTRIBUTING.md](https://github.com/barazo-forum/.github/blob/main/CONTRIBUTING.md) for full guidelines
96
97
---
98
···
100
101
| Repository | Description | License |
102
|------------|-------------|---------|
103
-
| [barazo-api](https://github.com/barazo-forum/barazo-api) | AppView backend -- Fastify, firehose, API | AGPL-3.0 |
104
-
| [barazo-web](https://github.com/barazo-forum/barazo-web) | Forum frontend -- Next.js, Tailwind | MIT |
105
-
| [barazo-lexicons](https://github.com/barazo-forum/barazo-lexicons) | Lexicon schemas + generated TypeScript types | MIT |
106
-
| [barazo-deploy](https://github.com/barazo-forum/barazo-deploy) | Docker Compose templates for self-hosting | MIT |
107
-
| [barazo-website](https://github.com/barazo-forum/barazo-website) | Marketing + docs site (barazo.forum) | MIT |
108
-
| [.github](https://github.com/barazo-forum/.github) | Org-level community health files | MIT |
109
110
---
111
112
## Community
113
114
- **Website:** [barazo.forum](https://barazo.forum)
115
-
- **Discussions:** [GitHub Discussions](https://github.com/orgs/barazo-forum/discussions)
116
-
- **Issues:** [Report bugs](https://github.com/barazo-forum/barazo-workspace/issues)
117
118
---
119
···
1
<div align="center">
2
3
<picture>
4
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/singi-labs/.github/main/assets/logo-dark.svg">
5
+
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/singi-labs/.github/main/assets/logo-light.svg">
6
+
<img alt="Barazo Logo" src="https://raw.githubusercontent.com/singi-labs/.github/main/assets/logo-dark.svg" width="120">
7
</picture>
8
9
# Barazo Workspace
···
29
30
| Directory | Repository | Description |
31
|-----------|-----------|-------------|
32
+
| `barazo-api/` | [barazo-api](https://github.com/singi-labs/barazo-api) | AppView backend (Fastify, AT Protocol) |
33
+
| `barazo-web/` | [barazo-web](https://github.com/singi-labs/barazo-web) | Forum frontend (Next.js, React) |
34
+
| `barazo-lexicons/` | [barazo-lexicons](https://github.com/singi-labs/barazo-lexicons) | AT Protocol lexicon schemas + generated types |
35
+
| `barazo-deploy/` | [barazo-deploy](https://github.com/singi-labs/barazo-deploy) | Docker Compose templates for self-hosting |
36
+
| `barazo-website/` | [barazo-website](https://github.com/singi-labs/barazo-website) | Marketing + docs site (barazo.forum) |
37
38
## Shared Configuration
39
···
55
56
```bash
57
# Clone the workspace root
58
+
git clone https://github.com/singi-labs/barazo-workspace.git singi-labs
59
+
cd singi-labs
60
61
# Clone each sub-project
62
+
git clone https://github.com/singi-labs/barazo-api.git
63
+
git clone https://github.com/singi-labs/barazo-web.git
64
+
git clone https://github.com/singi-labs/barazo-lexicons.git
65
+
git clone https://github.com/singi-labs/barazo-deploy.git
66
+
git clone https://github.com/singi-labs/barazo-website.git
67
68
# Install all dependencies (workspace-wide)
69
pnpm install
···
92
- Conventional commits enforced via commitlint + husky
93
- Strict TypeScript (`strict: true`, no `any`)
94
- All changes via Pull Requests (never commit directly to `main`)
95
+
- See [CONTRIBUTING.md](https://github.com/singi-labs/.github/blob/main/CONTRIBUTING.md) for full guidelines
96
97
---
98
···
100
101
| Repository | Description | License |
102
|------------|-------------|---------|
103
+
| [barazo-api](https://github.com/singi-labs/barazo-api) | AppView backend -- Fastify, firehose, API | AGPL-3.0 |
104
+
| [barazo-web](https://github.com/singi-labs/barazo-web) | Forum frontend -- Next.js, Tailwind | MIT |
105
+
| [barazo-lexicons](https://github.com/singi-labs/barazo-lexicons) | Lexicon schemas + generated TypeScript types | MIT |
106
+
| [barazo-deploy](https://github.com/singi-labs/barazo-deploy) | Docker Compose templates for self-hosting | MIT |
107
+
| [barazo-website](https://github.com/singi-labs/barazo-website) | Marketing + docs site (barazo.forum) | MIT |
108
+
| [.github](https://github.com/singi-labs/.github) | Org-level community health files | MIT |
109
110
---
111
112
## Community
113
114
- **Website:** [barazo.forum](https://barazo.forum)
115
+
- **Discussions:** [GitHub Discussions](https://github.com/orgs/singi-labs/discussions)
116
+
- **Issues:** [Report bugs](https://github.com/singi-labs/barazo-workspace/issues)
117
118
---
119
+2
-2
agents-md/repos/barazo-api.md
+2
-2
agents-md/repos/barazo-api.md
···
1
# Barazo API -- AppView Backend
2
3
<!-- Auto-generated from barazo-workspace. To propose changes, edit the source:
4
-
https://github.com/barazo-forum/barazo-workspace/tree/main/agents-md -->
5
6
-
AGPL-3.0 | Part of [github.com/barazo-forum](https://github.com/barazo-forum)
7
8
The AppView backend for Barazo. Subscribes to AT Protocol firehose, indexes `forum.barazo.*` records in PostgreSQL, and exposes a REST API for all forum operations.
9
···
1
# Barazo API -- AppView Backend
2
3
<!-- Auto-generated from barazo-workspace. To propose changes, edit the source:
4
+
https://github.com/singi-labs/barazo-workspace/tree/main/agents-md -->
5
6
+
AGPL-3.0 | Part of [github.com/singi-labs](https://github.com/singi-labs)
7
8
The AppView backend for Barazo. Subscribes to AT Protocol firehose, indexes `forum.barazo.*` records in PostgreSQL, and exposes a REST API for all forum operations.
9
+2
-2
agents-md/repos/barazo-deploy.md
+2
-2
agents-md/repos/barazo-deploy.md
···
1
# Barazo Deploy -- Self-Hosting Templates
2
3
<!-- Auto-generated from barazo-workspace. To propose changes, edit the source:
4
-
https://github.com/barazo-forum/barazo-workspace/tree/main/agents-md -->
5
6
-
MIT | Part of [github.com/barazo-forum](https://github.com/barazo-forum)
7
8
Docker Compose templates and documentation for self-hosting a Barazo forum instance.
9
···
1
# Barazo Deploy -- Self-Hosting Templates
2
3
<!-- Auto-generated from barazo-workspace. To propose changes, edit the source:
4
+
https://github.com/singi-labs/barazo-workspace/tree/main/agents-md -->
5
6
+
MIT | Part of [github.com/singi-labs](https://github.com/singi-labs)
7
8
Docker Compose templates and documentation for self-hosting a Barazo forum instance.
9
+2
-2
agents-md/repos/barazo-docs.md
+2
-2
agents-md/repos/barazo-docs.md
···
1
# Barazo Docs -- Documentation Site
2
3
<!-- Auto-generated from barazo-workspace. To propose changes, edit the source:
4
-
https://github.com/barazo-forum/barazo-workspace/tree/main/agents-md -->
5
6
-
MIT | Part of [github.com/barazo-forum](https://github.com/barazo-forum)
7
8
Documentation site for Barazo at docs.barazo.forum. Built with Fumadocs (Next.js).
9
···
1
# Barazo Docs -- Documentation Site
2
3
<!-- Auto-generated from barazo-workspace. To propose changes, edit the source:
4
+
https://github.com/singi-labs/barazo-workspace/tree/main/agents-md -->
5
6
+
MIT | Part of [github.com/singi-labs](https://github.com/singi-labs)
7
8
Documentation site for Barazo at docs.barazo.forum. Built with Fumadocs (Next.js).
9
+2
-2
agents-md/repos/barazo-lexicons.md
+2
-2
agents-md/repos/barazo-lexicons.md
···
1
# Barazo Lexicons -- Schema Definitions
2
3
<!-- Auto-generated from barazo-workspace. To propose changes, edit the source:
4
-
https://github.com/barazo-forum/barazo-workspace/tree/main/agents-md -->
5
6
-
MIT | Part of [github.com/barazo-forum](https://github.com/barazo-forum)
7
8
Lexicon schemas for the Barazo forum platform. Defines all `forum.barazo.*` record types and generates TypeScript types consumed by barazo-api and barazo-web.
9
···
1
# Barazo Lexicons -- Schema Definitions
2
3
<!-- Auto-generated from barazo-workspace. To propose changes, edit the source:
4
+
https://github.com/singi-labs/barazo-workspace/tree/main/agents-md -->
5
6
+
MIT | Part of [github.com/singi-labs](https://github.com/singi-labs)
7
8
Lexicon schemas for the Barazo forum platform. Defines all `forum.barazo.*` record types and generates TypeScript types consumed by barazo-api and barazo-web.
9
+2
-2
agents-md/repos/barazo-web.md
+2
-2
agents-md/repos/barazo-web.md
···
1
# Barazo Web -- Default Frontend
2
3
<!-- Auto-generated from barazo-workspace. To propose changes, edit the source:
4
-
https://github.com/barazo-forum/barazo-workspace/tree/main/agents-md -->
5
6
-
MIT | Part of [github.com/barazo-forum](https://github.com/barazo-forum)
7
8
The default frontend for Barazo forums. Communicates with the AppView backend exclusively via REST API. Forum admins can customize or replace entirely.
9
···
1
# Barazo Web -- Default Frontend
2
3
<!-- Auto-generated from barazo-workspace. To propose changes, edit the source:
4
+
https://github.com/singi-labs/barazo-workspace/tree/main/agents-md -->
5
6
+
MIT | Part of [github.com/singi-labs](https://github.com/singi-labs)
7
8
The default frontend for Barazo forums. Communicates with the AppView backend exclusively via REST API. Forum admins can customize or replace entirely.
9
+2
-2
agents-md/repos/barazo-website.md
+2
-2
agents-md/repos/barazo-website.md
···
1
# Barazo Website -- Marketing Site
2
3
<!-- Auto-generated from barazo-workspace. To propose changes, edit the source:
4
-
https://github.com/barazo-forum/barazo-workspace/tree/main/agents-md -->
5
6
-
MIT | Part of [github.com/barazo-forum](https://github.com/barazo-forum)
7
8
Marketing site for Barazo at barazo.forum. Built with Astro. Documentation lives in barazo-docs (docs.barazo.forum).
9
···
1
# Barazo Website -- Marketing Site
2
3
<!-- Auto-generated from barazo-workspace. To propose changes, edit the source:
4
+
https://github.com/singi-labs/barazo-workspace/tree/main/agents-md -->
5
6
+
MIT | Part of [github.com/singi-labs](https://github.com/singi-labs)
7
8
Marketing site for Barazo at barazo.forum. Built with Astro. Documentation lives in barazo-docs (docs.barazo.forum).
9