heisenberg-xx/fring

How heisenberg-xx/fring works

Fring is a Next.js architecture CLI: users create a scaffolded project, add the Fring Table package, generate module folders, or check their environment. The main creation workflow gathers options and runs project setup; a separate table workflow validates the target, prepares Shadcn UI when needed, installs TanStack Table, and copies templates. The graph preserves those distinct capabilities and the generated auth, provider, API-client, and starter-page layers. Some command implementations and generated template contents were not sampled, so uncertain command-to-service wiring is omitted.

Main entry points: project-creator.ts Project creator · index.ts Command router · table.ts Table setup · table-generator.ts Table generator

Components 25

CLI entry

Command router src/index.ts
New command src/commands/new.ts
Add command src/commands/add.ts
Generate command src/commands/generate.ts
Doctor command src/commands/doctor.ts

Project creation

Project options src/prompts/new-project.ts
Project creator src/services/project-creator.ts
Next.js scaffolder
Project templates src/generators/project-creation
Auth templates src/generators/project-creation/auth-template-generator.ts
Starter pages src/generators/project-creation/start-page-generator.ts
Query providers src/generators/project-creation/tanstack-providers-generator.ts
Axios client src/generators/project-creation/axios-instance-generator.ts
Environment config src/generators/project-creation/env-template-generator.ts

Project extensions

Module generator src/generators/module-generate/module-generator.ts
Table setup src/services/table.ts
Table generator src/generators/table/table-generator.ts
Shadcn setup src/utils/initialize-shadcn.ts
Shadcn components src/utils/add-shadcn-components.ts
Package manager src/utils/package-manager.ts
Next.js check src/utils/is-next-project.ts
Table templates templates/add/table

Environment support

Environment check src/commands/doctor.ts

Other components

Developer
Git executable

Connections 21

Developer → Command router: runs commands
Command router → New command: dispatches new
Command router → Add command: dispatches add
Command router → Generate command: dispatches generate
Command router → Doctor command: dispatches doctor
New command → Project options: gathers options
Project creator → Next.js scaffolder: creates app
Project creator → Project templates: runs setup
Project creator → Auth templates: generates auth
Project creator → Starter pages: generates pages
Project creator → Query providers: generates providers
Project creator → Axios client: generates client
Project creator → Environment config: generates config
Project creator → Package manager: selects commands
Table setup → Next.js check: checks project
Table setup → Shadcn setup: initializes UI
Table setup → Shadcn components: adds components
Table setup → Table generator: runs generation
Table generator → Package manager: selects commands
Table generator → Table templates: copies templates
Environment check → Git executable: checks version

More TypeScript diagrams: kessler/gemma-gem · leonardsellem/plaud-sync-for-obsidian · maggieappleton/lodestone · massdo/repomix-runner · miguel07alm/arxivtok

Drawn by GitDiagram on September 28, 2026 from the repository's file tree, README and source files. Read as Markdown ·