Website, docs, and blog for Soma.
soma.gravicity.ai · Docs · Blog · Hub · Roadmap
- Astro — static site with islands
- Vercel — auto-deploys from
mainbranch - Content — Markdown collections (docs, blog, changelog)
pnpm install
pnpm dev # localhost:4321# Work on dev branch git checkout dev # ... make changes ... git add -A && git commit -m "docs: ..." git push # Deploy: merge to main git checkout main git merge dev --ff-only git push # Vercel auto-deploys git checkout dev
| Content | Source | Sync |
|---|---|---|
| Docs | repos/agent/docs/*.md |
Manual copy → preserve Astro frontmatter |
| Blog | Written here in src/content/blog/ |
Native |
| Changelog | repos/agent/CHANGELOG.md |
soma-changelog-json.sh --sync |
| Roadmap | public/data/roadmap.json |
Curated (don't auto-overwrite) |
| Hub | repos/community/hub-index.json |
fetch-community.mjs at build |
src/
content/
docs/ 27 documentation pages
blog/ published posts
pages/ Astro routes
layouts/ DocsLayout, BlogLayout
components/ islands (changelog, roadmap, hub)
public/
data/ changelog.json, roadmap.json
BSL 1.1 © Curtis Mercier — open source 2027