golid
golid-ai · golid-ai/golid
An AI-native software factory for Go + SolidJS apps, providing a production harness with plans, module specs, 45 Cursor rules, drift CI, and a starter app with GCP deployment.
AI-native factory for Go + SolidJS apps — Cursor rules, spec drift CI, plans, and a production starter with auth, SSR, SSE, Cloud Run deploy.
Preview
What you can do with it
- Rapidly build and deploy full-stack Go + SolidJS web applications with AI assistance.
- Maintain code quality and architectural consistency using 45 predefined Cursor rules.
- Automate development workflows including specification validation and integration testing.
Safety check
No risky patterns found in the files we scanned.
Automated scan of the repo files. Always review code you run.
From the README
Golid
An AI-native software factory for cloud-hosted Go + SolidJS apps.
Production harness — plans, module specs, 45 Cursor rules, drift CI, integration test harness — plus a runnable starter app and GCP deploy scripts.
Live example: golid.ai — marketing site built with this factory; clone the repo for the harness and template app.
Factory · Quick Start · Fork · Why Golid · Deploy · Docs
Tech Stack
| Layer | Technology | Layer | Technology |
|---|---|---|---|
| Backend | Go 1.26 · Echo v4 · pgx/v5 | Frontend | SolidJS · SolidStart · Tailwind CSS 4 |
| Database | PostgreSQL 16 | Infrastructure | Cloud Run · Cloud SQL · GCS |
| Auth | JWT rotation · selector/verifier tokens | Real-time | SSE hub with ticket auth |
Mailgun (IsConfigured()) | Job Queue | asynq + Redis (goroutine fallback) | |
| Observability | OpenTelemetry · Prometheus (opt-in) | Feature Flags | DB-backed with 30s cache |
| Hot Reload | Air (Go) + Vite HMR | DevContainer | One-click setup, zero config |
| Testing | 995 tests (353 Go unit + 622 Vitest + 20 E2E) | Factory harness | Plans · spec-drift · rule-health · plan loop |
| AI Rules | 45 Cursor rules (auto-activate on edit) | Integration | TEST_DATABASE_URL · per-package schemas (separate go test -tags integration run) |
How the factory works
Agents and humans share the same production contract — not prompt memory, not ad-hoc CI.
1. Classify & plan — workflow-routing picks risk tier (T0–T3). Write slices in docs/plans/ under planning-standards guardrails: verify schema and file claims against migrations and source; acceptance criteria per slice. New modules: plan-feature. Calibration: golden-slices.
2. Execute slices — slice-and-ship per slice: implement → test → spec/OpenAPI sync → audit-bugs pre-merge gate → commit. For multi-slice plans, invoke plan-execution-loop to orchestrate subagents: implement → audit (≥90/100) → fix → re-audit before the next slice. Archive completed plans under docs/plans/archive/.
| Step | What | Where |
|---|---|---|
| Spec | Current behavior (updated as slices land) | docs/modules/*/spec.md |
| Build | Rules + scaffold enforce patterns | .cursor/rules/ · make new-module |
| Verify | Unit + integration harness, race detector | Per-package it__ schemas · sharded CI |
| Gate | Spec + rules stay aligned with code | check_spec_drift.sh · check_citation_freshness.sh · check_rule_health.sh on every PR |
| Ship | Cloud deploy + full rebrand | ./scripts/deploy.sh · make rename (20+ file categories) |
vs blank repo + AI: OpenAPI + module specs + drift CI (not prompt memory) · planning-standards → slice-and-ship / plan-execution-loop · path-filtered CI + E2E + Codecov 80% gate · make rename rebrands the whole factory.
Full map: Organism Pattern · Plans · routing eval
What's Inside
Starter modules the factory extends — use make new-module or follow example-module.md.
| Module | What it does |
|---|---|
| Auth | Registration, login, JWT refresh rotation, password reset, email verification |
| Users | Profile (/me), settings, admin user_type gates |
| Feature flags | Public GET /features, admin CRUD, cached reads |
| SSE | Per-user channels, one-time ticket auth, reconnect + backpressure |
| Components | 70+ atoms/molecules/organisms — charts, grids, date pickers, modals |
| Opt-in infra | Email, queue, Redis rate limiting, tracing, metrics — off by default |
Also included: OpenAPI 3.1 + TypeScript codegen, sqlc queries, golang-migrate (with down migrations), CSRF + dual-tier rate limiting, scaffold generator, domain-safe rename tool, GCP deploy/teardown scripts.
Quick Start
Prerequisites: Docker 24+, Node.js 24+, Go 1.26+
DevContainer (recommended)
git clone https://github.com/golid-ai/golid.git my-project && cd my-project
# Open in VS Code/Cursor → "Reopen in Container"
Migrations and seed data run automatically (entrypoint.dev.sh). Backend starts on 8080. Frontend starts as a VS Code task — open the Terminal tab and wait until the frontend dev server prints its local URL before opening http://localhost:3000.
Docker Compose (local)
git clone https://github.com/golid-ai/golid.git my-project && cd my-project
make setup
# First run only — migrate + seed the dev database
export DATABASE_URL=postgres://dev:dev@localhost:5432/golid?sslmode=disable
make migrate-up seed
docker compose up # DB + backend on :8080
cd frontend && npm run dev # frontend on :3000
Test accounts (after seed): admin@example.com / Password123! (admin) · user@example.com / Password123! (user)
Guides: Quick Start · [Start Here](docs/start-here.