Go + React. Built with Grit.

The full-stack Go + React framework. Choose your architecture, pick your frontend, and scaffold a production-ready application in seconds.

Grit is a full-stack meta-framework that fuses Go (Gin + GORM) with Next.js or TanStack Router (Vite) in a flexible architecture. One interactive CLI to scaffold a complete production-ready project with authentication, 2FA, admin panel, code generation, file storage, email, background jobs, AI integration, one-command deployment, and Docker setup.

One-line install — works on macOS, Linux, and Windows (PowerShell or Git Bash). No Go toolchain required:

curl -fsSL https://gritframework.dev/install.sh | sh

Pin a specific version:

GRIT_VERSION=v3.27.0 curl -fsSL https://gritframework.dev/install.sh | sh

Already have Go installed? go install still works as an alternative:

go install github.com/MUKE-coder/grit/v3/cmd/grit@latest
# or pin: go install github.com/MUKE-coder/grit/v3/cmd/grit@v3.27.0

Verify the install:

grit version
# grit version 3.27.0

Update to the latest release:

grit update

# Interactive — choose architecture + frontend
grit new myapp

# Or use flags to skip prompts
grit new myapp --triple --next       # Web + Admin + API (Next.js)
grit new myapp --double --vite       # Web + API (TanStack Router)
grit new myapp --single              # Single Go binary + embedded SPA
grit new myapp --api                 # Go API only
grit new . --triple --vite           # Scaffold into current directory
grit new ./ --triple --vite          # Same as above
grit new-desktop myapp               # Native desktop app (Wails)

Tip: when using grit new ., Grit infers the project name from your current folder name. Use --force if the directory is non-empty.

cd myapp
docker compose up -d    # PostgreSQL, Redis, MinIO, Mailhog
pnpm install && pnpm dev

Open http://localhost:3000 — register, log in, see the dashboard.

# Generate a full-stack resource
grit generate resource Post --fields "title:string,content:richtext,published:bool,slug:slug:title"

# Interactive mode
grit generate resource Product -i

# From YAML
grit generate resource Post --from post.yaml

# Remove a resource (deletes files + reverses injections)
grit remove resource Post

Generated files per resource: Go model, service, handler, Zod schema, TypeScript types, React Query hooks, admin page, route injection — all via code markers.

# Scaffolding
grit new <name>                        # Interactive (architecture + frontend)
grit new <name> --triple --next        # Explicit flags
grit new . --triple --vite             # Scaffold into current directory
grit new-desktop <name>                # Desktop app (Wails)

# Code generation
grit generate resource <Name> --fields "..."
grit remove resource <Name>
grit add role <ROLE_NAME>
grit sync                              # Go types → TypeScript + Zod

# Development
grit start                             # Auto-detect project, start dev server
grit start client                      # Start frontend apps
grit start server                      # Start Go API
grit studio                            # Open GORM Studio
grit routes                            # List all registered API routes

# Database
grit migrate                           # Run migrations
grit migrate --fresh                   # Drop + re-migrate
grit seed                              # Seed database

# Operations
grit down                              # Maintenance mode (503 all requests)
grit up                                # Back online
grit deploy --host user@server.com --domain myapp.com

# Meta
grit version                           # v3.27.0
grit update                            # Self-update to latest
grit upgrade                           # Upgrade project templates

Modifiers: :unique, :optional, :slug:<source>, :belongs_to:<Model>, :many_to_many:<Model>

Grit extends in two different ways. They're often confused, so the distinction matters:

Installs a feature by generating real code into your project — models, routes, admin pages, frontend components — recorded in .grit/plugins.lock.json so grit plugin remove reverses every file and injection. You own and can edit the result. Run grit plugin list to see what's available:

grit plugin add multitenant       # organizations, per-org roles, query scoping
grit plugin add impersonate       # sign in as another user, with an audit trail
grit plugin add command-palette   # ⌘K navigation across the admin
grit plugin add saved-views       # per-user named table views

Ordinary Go modules you import and wire up yourself. They hold runtime logic (a WebSocket hub, a Stripe client, an OAuth manager) and upgrade with go get -u. These are not installed by grit plugin add.

go get github.com/MUKE-coder/grit-plugins/grit-websockets@v0.1.0

Status: v0.3.0, early. These build and vet clean and now carry contract tests (35 across the ten) plus per-module CI. Behavioural tests against live services (Meilisearch, FFmpeg, Stripe) are still a TODO. grit-notifications, grit-video, grit-webhooks and grit-conference still store user_id as uint, while a Grit User.ID is a UUID string — so linking them to a Grit user needs a change first. grit-oauth and grit-stripe are already fixed. Treat them as a starting point, not a supported dependency.

Check core first. Several of these overlap with modules you already have behind MODULE_* flags. In particular grit-websockets duplicates MODULE_REALTIME — a scaffolded app already ships internal/realtime and a WebSocket handler wired to your AuthService. grit-export overlaps internal/export (it adds PDF). grit-webhooks does not overlap despite the name: core verifies incoming webhooks, that package sends outgoing ones. The repo README has the full per-package comparison.

All are github.com/MUKE-coder/grit-plugins/<module>:

Full docs at gritframework.dev — architecture guides, tutorials, the 10-course free curriculum at /courses, API reference, deployment, and plugin documentation.

Grit is free and MIT licensed. Sponsorship pays for the features, docs and releases everyone else gets for free — and puts your name in front of every developer who builds with Grit.

Grit has no sponsors yet. Be the first — your logo goes here, on the home page, and inside the CLI.

Become a sponsor →

Building with Grit? Add the badge to your README:

[![Built with Grit](https://gritframework.dev/badge/built-with-grit.svg)](https://gritframework.dev)

MIT