How muke-coder/grit works
Grit is a Go CLI that scaffolds and evolves full-stack applications: users describe a project or resource, the CLI generates ordinary application code, and they run the resulting app. Its generator and scaffold packages cover API, admin and web output, alongside documented auth, jobs, storage, deploy and other built-in capabilities. The repository also includes a UI component registry site and CLI commands to install or swap its components. Some feature implementations are unsampled, so those branches are shown at their supported directory level.
Main entry points: main.go Grit CLI · scaffold Project scaffolder · block-viewer.tsx Component viewer · page.tsx Registry website
Components 19
CLI workflows
- Grit CLI
cmd/grit/main.go - Project doctor
internal/doctor/doctor.go - AI project tools
internal/mcp/tools_project.go - Component swap
internal/swap/swap.go
Project generation
- Resource generator
internal/generate/add_field_handler.go - Desktop generation
internal/generate/desktop_client.go - Project scaffolder
internal/scaffold - Public form templates
internal/expose/templates.go - Storage repair
internal/scaffold/storage_disk_repair.go
Generated app capabilities
- Deployment
internal/deploy - Plugin features
internal/plugin - Generated application
internal/scaffold
UI registry
- Component registry
ui/registry/catalog.ts - Registry website
ui/app/(site)/page.tsx - Component viewer
ui/components/block-viewer.tsx - Install command
ui/components/install-command.tsx - Install count
ui/components/install-count.tsx - Registry fetch
internal/uiregistry/uiregistry.go
Other components
- Developer
Connections 18
- Developer → Grit CLI: runs commands
README.md - Grit CLI → Resource generator: generates resources
cmd/grit/main.go - Grit CLI → Project scaffolder: scaffolds projects
cmd/grit/main.go - Grit CLI → Project doctor: checks projects
cmd/grit/main.go - Grit CLI → AI project tools: serves AI tools
- Grit CLI → Deployment: deploys projects
cmd/grit/main.go - Grit CLI → Plugin features: manages plugins
cmd/grit/main.go - Grit CLI → Desktop generation: generates desktop
cmd/grit/main.go - Grit CLI → Public form templates: exposes forms
internal/expose/templates.go - Resource generator → Project scaffolder: uses templates
- Project scaffolder → Generated application: emits app files
README.md - Project scaffolder → Storage repair: repairs storage
internal/scaffold/storage_disk_repair.go - Registry website → Component registry: shows components
- Registry website → Component viewer: renders previews
- Component viewer → Install command: renders command
ui/components/block-viewer.tsx - Component viewer → Install count: shows count
ui/components/block-viewer.tsx - Developer → Component swap: swaps components
README.md - Component swap → Registry fetch: fetches variant
internal/swap/swap.go