Golid: An AI-native software factory
Build cloud-hosted apps with Go + SolidJS
Plans, module specs, and agent ops — not prompt memory.
45 Cursor rules, audit gates, drift CI, and a real integration test harness. Runnable starter app and GCP deploy scripts included.
Live example: this site. Clone the repo for the factory and template app.
What's included
Reopen in Container5 min setup
How the factory works
Agents and humans share the same production contract. Not prompt memory. Not ad-hoc CI.
Classify & plan
workflow-routing picks risk tier. Slices live in docs/plans/ with acceptance criteria per slice.
Execute slices
slice-and-ship per slice: implement, test, spec/OpenAPI sync, audit-bugs gate, commit.
Spec as contract
docs/modules/*/spec.md tracks current behavior. check_spec_drift.sh gates every PR.
Ship & rebrand
deploy.sh to Cloud Run. make rename rebrands 20+ file categories across the whole factory.
Up and running in minutes
DevContainer recommended. Migrations and seed data run automatically.
# DevContainer (recommended)
git clone https://github.com/golid-ai/golid.git my-project
cd my-project # Open in VS Code/Cursor → Reopen in Container
# Or Docker Compose locally
make setup && docker compose up
# Frontend: localhost:3000 | Backend: localhost:8080
# Scaffold a CRUD module
make new-module name=notes
# Rebrand the entire factory
make rename name=myapp module=github.com/you/myapp/backendHarness + starter app
Everything the factory extends: auth, components, SSE, feature flags, and opt-in infra.
45 Cursor Rules
Sibling pairs auto-activate by file type (solidjs-pages + solidjs-data-fetching, go-service + go-service-errors). audit-bugs gate before commit. Agents and humans share the same contract.
995 Tests
353 Go unit + 622 Vitest + 20 E2E. Real PostgreSQL integration harness with per-package schemas. Codecov 80% gate.
70+ Components
Production UI library with charts, grids, date pickers, modals, and 3D canvas. Dark mode, accessibility, and axe-core CI.
Auth Built-In
JWT refresh rotation, selector/verifier tokens, email verification, role-based access. Two-layer auth on every endpoint.
SSR + Real-Time
SolidStart SSR with middleware auth redirects. SSE hub with ticket auth, backpressure, and reconnect.
One-Command Deploy
Cloud Run, Cloud SQL, VPC, secrets, and IAM via ./scripts/deploy.sh. Also Fly.io, Railway, Render, or bare metal.
vs blank repo + AI
OpenAPI, module specs, and drift CI. Not prompt memory.
| Golid | Blank repo + AI | |
|---|---|---|
| Contract | OpenAPI + specs + drift CI | Prompt memory |
| Integration safety | TEST_DATABASE_URL, isolated schemas | Easy to wipe dev DB |
| Agent ops | 45 rules, audit → commit | Ad-hoc |
| Production CI | Path-filtered, E2E, Codecov 80% | Often none |
| Fork factory | make rename (20+ categories) | Manual find-and-replace |
vs other stacks
| Golid | Next.js + API | Go starters | |
|---|---|---|---|
| Full-stack type safety | Go + TS via OpenAPI types | tRPC/Zod | Go only |
| Production UI | 70+ components | BYO | None |
| SSR + real-time | SolidStart + SSE | Partial | None |
| Deploy | One-command GCP | Vercel-centric | BYO |
| Memory | ~30MB binary | ~200MB+ | ~30MB |
Scaffold a full CRUD module in seconds
make new-module generates migration, service, handler, tests, and frontend route. All following established patterns.
Opt-in modules
docker compose up works with zero Redis, Mailgun, or OTEL. Set one env var when you need it.
| Module | Trigger | Zero-config | Production |
|---|---|---|---|
MAILGUN_API_KEY | Logs to stdout | Mailgun delivery | |
| Job Queue | REDIS_URL | Goroutine + retry | asynq + Redis |
| Rate Limiting | REDIS_URL | In-memory | Redis fixed-window |
| Tracing | OTEL_ENDPOINT | No tracing | OTLP export |
| Metrics | METRICS_ENABLED | No /metrics | Prometheus |
| Feature Flags | Always on | PostgreSQL + cache | Same |
Production-grade patterns everywhere
Backend
- apperror typed responses. No leaked internals.
- Parameterized queries, rows.Err(), transactions for multi-write
- TOCTOU-safe refresh, selector/verifier tokens
- Graceful shutdown: drain HTTP, close SSE, release DB pool
- Integration tests with real PostgreSQL, race detector
Frontend
- onMount + signals + alive guard + batch(). No createResource.
- Switch/Match for content states, no nested Show
- SSR middleware auth redirects, reactive 401 logout
- Accessibility: ARIA, keyboard nav, focus trapping, axe-core CI
- Vitest 4 + Playwright E2E, Codecov 80% gate
Clone the factory
Runnable starter app, 45 Cursor rules, audit gates, drift CI, and one-command deploy. MIT licensed, open source, no vendor lock-in.