# muke-coder/grit architecture

> Architecture diagram of the GitHub repository muke-coder/grit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/muke-coder/grit
- Repository: https://github.com/muke-coder/grit

## Overview

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: [`cmd/grit/main.go`](https://github.com/muke-coder/grit/blob/main/cmd/grit/main.go) (Grit CLI), [`internal/scaffold`](https://github.com/muke-coder/grit/tree/main/internal/scaffold) (Project scaffolder), [`ui/components/block-viewer.tsx`](https://github.com/muke-coder/grit/blob/main/ui/components/block-viewer.tsx) (Component viewer), [`ui/app/(site)/page.tsx`](https://github.com/muke-coder/grit/blob/main/ui/app/(site)/page.tsx) (Registry website)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflows"]
  node_cli["Grit CLI<br/>[main.go]"]
  node_doctor["Project doctor<br/>[doctor.go]"]
  node_mcp["AI project tools<br/>[tools_project.go]"]
  node_swap["Component swap<br/>[swap.go]"]
end

subgraph group_generation["Project generation"]
  node_generator["Resource generator"]
  node_desktop["Desktop generation<br/>[desktop_client.go]"]
  node_scaffolder["Project scaffolder"]
  node_publicforms["Public form templates<br/>[templates.go]"]
  node_storage["Storage repair"]
end

subgraph group_capabilities["Generated app capabilities"]
  node_deploy["Deployment"]
  node_plugins["Plugin features"]
  node_generatedapp["Generated application"]
end

subgraph group_ui["UI registry"]
  node_registry["Component registry<br/>[catalog.ts]"]
  node_site["Registry website<br/>[page.tsx]"]
  node_blockviewer["Component viewer<br/>[block-viewer.tsx]"]
  node_installcommand["Install command"]
  node_installcount["Install count<br/>[install-count.tsx]"]
  node_uiregistry["Registry fetch<br/>[uiregistry.go]"]
end

node_developer(("Developer"))

node_developer -->|"runs commands"| node_cli
node_cli -->|"generates resources"| node_generator
node_cli -->|"scaffolds projects"| node_scaffolder
node_cli -->|"checks projects"| node_doctor
node_cli -.->|"serves AI tools"| node_mcp
node_cli -->|"deploys projects"| node_deploy
node_cli -->|"manages plugins"| node_plugins
node_cli -->|"generates desktop"| node_desktop
node_cli -->|"exposes forms"| node_publicforms
node_generator -->|"uses templates"| node_scaffolder
node_scaffolder -->|"emits app files"| node_generatedapp
node_scaffolder -->|"repairs storage"| node_storage
node_site -.->|"shows components"| node_registry
node_site -.->|"renders previews"| node_blockviewer
node_blockviewer -->|"renders command"| node_installcommand
node_blockviewer -->|"shows count"| node_installcount
node_developer -->|"swaps components"| node_swap
node_swap -->|"fetches variant"| node_uiregistry

click node_cli "https://github.com/muke-coder/grit/blob/main/cmd/grit/main.go"
click node_generator "https://github.com/muke-coder/grit/blob/main/internal/generate/add_field_handler.go"
click node_desktop "https://github.com/muke-coder/grit/blob/main/internal/generate/desktop_client.go"
click node_scaffolder "https://github.com/muke-coder/grit/tree/main/internal/scaffold"
click node_publicforms "https://github.com/muke-coder/grit/blob/main/internal/expose/templates.go"
click node_doctor "https://github.com/muke-coder/grit/blob/main/internal/doctor/doctor.go"
click node_mcp "https://github.com/muke-coder/grit/blob/main/internal/mcp/tools_project.go"
click node_storage "https://github.com/muke-coder/grit/blob/main/internal/scaffold/storage_disk_repair.go"
click node_deploy "https://github.com/muke-coder/grit/tree/main/internal/deploy"
click node_plugins "https://github.com/muke-coder/grit/tree/main/internal/plugin"
click node_generatedapp "https://github.com/muke-coder/grit/tree/main/internal/scaffold"
click node_registry "https://github.com/muke-coder/grit/blob/main/ui/registry/catalog.ts"
click node_site "https://github.com/muke-coder/grit/blob/main/ui/app/(site)/page.tsx"
click node_blockviewer "https://github.com/muke-coder/grit/blob/main/ui/components/block-viewer.tsx"
click node_installcommand "https://github.com/muke-coder/grit/blob/main/ui/components/install-command.tsx"
click node_installcount "https://github.com/muke-coder/grit/blob/main/ui/components/install-count.tsx"
click node_swap "https://github.com/muke-coder/grit/blob/main/internal/swap/swap.go"
click node_uiregistry "https://github.com/muke-coder/grit/blob/main/internal/uiregistry/uiregistry.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_doctor,node_mcp,node_swap toneBlue
class node_generator,node_desktop,node_scaffolder,node_publicforms,node_storage toneAmber
class node_deploy,node_plugins,node_generatedapp toneMint
class node_registry,node_site,node_blockviewer,node_installcommand,node_installcount,node_uiregistry toneRose
class node_developer toneIndigo
```

## Components

### CLI workflows

- [Grit CLI](https://github.com/muke-coder/grit/blob/main/cmd/grit/main.go): `cmd/grit/main.go`
- [Project doctor](https://github.com/muke-coder/grit/blob/main/internal/doctor/doctor.go): `internal/doctor/doctor.go`
- [AI project tools](https://github.com/muke-coder/grit/blob/main/internal/mcp/tools_project.go): `internal/mcp/tools_project.go`
- [Component swap](https://github.com/muke-coder/grit/blob/main/internal/swap/swap.go): `internal/swap/swap.go`

### Project generation

- [Resource generator](https://github.com/muke-coder/grit/blob/main/internal/generate/add_field_handler.go): `internal/generate/add_field_handler.go`
- [Desktop generation](https://github.com/muke-coder/grit/blob/main/internal/generate/desktop_client.go): `internal/generate/desktop_client.go`
- [Project scaffolder](https://github.com/muke-coder/grit/tree/main/internal/scaffold): `internal/scaffold`
- [Public form templates](https://github.com/muke-coder/grit/blob/main/internal/expose/templates.go): `internal/expose/templates.go`
- [Storage repair](https://github.com/muke-coder/grit/blob/main/internal/scaffold/storage_disk_repair.go): `internal/scaffold/storage_disk_repair.go`

### Generated app capabilities

- [Deployment](https://github.com/muke-coder/grit/tree/main/internal/deploy): `internal/deploy`
- [Plugin features](https://github.com/muke-coder/grit/tree/main/internal/plugin): `internal/plugin`
- [Generated application](https://github.com/muke-coder/grit/tree/main/internal/scaffold): `internal/scaffold`

### UI registry

- [Component registry](https://github.com/muke-coder/grit/blob/main/ui/registry/catalog.ts): `ui/registry/catalog.ts`
- [Registry website](https://github.com/muke-coder/grit/blob/main/ui/app/(site)/page.tsx): `ui/app/(site)/page.tsx`
- [Component viewer](https://github.com/muke-coder/grit/blob/main/ui/components/block-viewer.tsx): `ui/components/block-viewer.tsx`
- [Install command](https://github.com/muke-coder/grit/blob/main/ui/components/install-command.tsx): `ui/components/install-command.tsx`
- [Install count](https://github.com/muke-coder/grit/blob/main/ui/components/install-count.tsx): `ui/components/install-count.tsx`
- [Registry fetch](https://github.com/muke-coder/grit/blob/main/internal/uiregistry/uiregistry.go): `internal/uiregistry/uiregistry.go`

### Other components

- **Developer**

## Connections

- Developer → Grit CLI: runs commands (evidence: `README.md`)
- Grit CLI → Resource generator: generates resources (evidence: `cmd/grit/main.go`)
- Grit CLI → Project scaffolder: scaffolds projects (evidence: `cmd/grit/main.go`)
- Grit CLI → Project doctor: checks projects (evidence: `cmd/grit/main.go`)
- Grit CLI → AI project tools: serves AI tools
- Grit CLI → Deployment: deploys projects (evidence: `cmd/grit/main.go`)
- Grit CLI → Plugin features: manages plugins (evidence: `cmd/grit/main.go`)
- Grit CLI → Desktop generation: generates desktop (evidence: `cmd/grit/main.go`)
- Grit CLI → Public form templates: exposes forms (evidence: `internal/expose/templates.go`)
- Resource generator → Project scaffolder: uses templates
- Project scaffolder → Generated application: emits app files (evidence: `README.md`)
- Project scaffolder → Storage repair: repairs storage (evidence: `internal/scaffold/storage_disk_repair.go`)
- Registry website → Component registry: shows components
- Registry website → Component viewer: renders previews
- Component viewer → Install command: renders command (evidence: `ui/components/block-viewer.tsx`)
- Component viewer → Install count: shows count (evidence: `ui/components/block-viewer.tsx`)
- Developer → Component swap: swaps components (evidence: `README.md`)
- Component swap → Registry fetch: fetches variant (evidence: `internal/swap/swap.go`)
