# angeloscode/next-arch architecture

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

- Interactive diagram: https://gitdiagram.com/angeloscode/next-arch
- Repository: https://github.com/angeloscode/next-arch

## Overview

next-arch combines a project-scaffolding CLI with an ESLint plugin that enforces the generated Feature-Sliced Design boundaries. The main user workflow is invoking a CLI command to initialize, generate, inspect, or remove project structures; initialization gathers selections and applies templates and package choices. The plugin analyzes imports to enforce layer direction, feature public APIs, and server/client separation. The README documents the scaffold’s app-to-view-to-widget/feature composition. Some command internals and templates were not sampled, so their relationships are included only where the README or source index supports them.

Main entry points: [`packages/next-arch/src/index.ts`](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/index.ts) (CLI commands), [`packages/eslint-plugin-next-arch/src/index.ts`](https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/index.ts) (ESLint rules), [`packages/next-arch/src/commands/init.ts`](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/commands/init.ts) (Initialize project), [`packages/next-arch/src/commands/page.ts`](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/commands/page.ts) (Add page preset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Project CLI"]
  node_cli_entry["CLI commands<br/>[index.ts]"]
  node_init["Initialize project<br/>[init.ts]"]
  node_page["Add page preset<br/>[page.ts]"]
  node_generate["Generate slice<br/>[generate.ts]"]
  node_doctor["Check architecture<br/>[doctor.ts]"]
  node_remove["Remove slice<br/>[remove.ts]"]
  node_doctor_checks["Architecture checks<br/>[doctor-checks.ts]"]
  node_import_scan["Importer scan<br/>[find-importers.ts]"]
end

subgraph group_scaffold["Scaffolding"]
  node_init_options["Init selections<br/>[init-prompts.ts]"]
  node_package_choices["Package templates<br/>[packages.ts]"]
  node_project_scaffold["Project template<br/>[copy.ts]"]
  node_page_templates["Page presets<br/>[page-presets.ts]"]
  node_template_renderer["Template rendering<br/>[template.ts]"]
end

subgraph group_plugin["Architecture linting"]
  node_plugin_entry["ESLint rules<br/>[index.ts]"]
  node_layer_model["Layer resolution<br/>[layers.ts]"]
  node_import_visitors["Import visitors<br/>[import-visitors.ts]"]
  node_boundary_rules["Import boundaries"]
  node_public_api_rule["Feature public API<br/>[no-deep-imports.ts]"]
  node_client_server_rule["Server/client boundary"]
  node_feature_rule["Feature isolation"]
end

subgraph group_appmodel["Generated app model"]
  node_app_layers["App layers<br/>[page.tsx]"]
  node_domain_presets["Domain page presets"]
end

node_developer(("Developer"))

node_developer -->|"runs commands"| node_cli_entry
node_cli_entry -->|"dispatches init"| node_init
node_cli_entry -->|"dispatches page"| node_page
node_cli_entry -->|"dispatches generate"| node_generate
node_cli_entry -->|"dispatches doctor"| node_doctor
node_cli_entry -->|"dispatches remove"| node_remove
node_init -->|"collects selections"| node_init_options
node_init -->|"applies selections"| node_package_choices
node_init -->|"copies template"| node_project_scaffold
node_page -->|"selects preset"| node_page_templates
node_page -->|"renders files"| node_template_renderer
node_generate -->|"delegates pages"| node_page
node_doctor -->|"runs checks"| node_doctor_checks
node_remove -->|"checks importers"| node_import_scan
node_plugin_entry -->|"registers rule"| node_boundary_rules
node_plugin_entry -->|"registers rule"| node_public_api_rule
node_plugin_entry -->|"registers rule"| node_client_server_rule
node_plugin_entry -->|"registers rule"| node_feature_rule
node_boundary_rules -->|"visits imports"| node_import_visitors
node_boundary_rules -->|"resolves layers"| node_layer_model
node_public_api_rule -->|"visits imports"| node_import_visitors
node_public_api_rule -->|"resolves feature paths"| node_layer_model
node_client_server_rule -->|"visits imports"| node_import_visitors
node_client_server_rule -->|"checks server paths"| node_layer_model
node_app_layers -.->|"scaffolds layouts"| node_domain_presets
node_developer -.->|"runs lint"| node_plugin_entry

click node_cli_entry "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/index.ts"
click node_init "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/commands/init.ts"
click node_page "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/commands/page.ts"
click node_generate "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/commands/generate.ts"
click node_doctor "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/commands/doctor.ts"
click node_remove "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/commands/remove.ts"
click node_init_options "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/init-prompts.ts"
click node_package_choices "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/packages.ts"
click node_project_scaffold "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/copy.ts"
click node_page_templates "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/page-presets.ts"
click node_template_renderer "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/template.ts"
click node_doctor_checks "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/doctor-checks.ts"
click node_import_scan "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/find-importers.ts"
click node_plugin_entry "https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/index.ts"
click node_layer_model "https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/utils/layers.ts"
click node_import_visitors "https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/utils/import-visitors.ts"
click node_boundary_rules "https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/rules/no-upward-imports.ts"
click node_public_api_rule "https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/rules/no-deep-imports.ts"
click node_client_server_rule "https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/rules/no-server-in-client.ts"
click node_feature_rule "https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/rules/no-cross-feature-imports.ts"
click node_app_layers "https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/templates/app/src/app/page.tsx"
click node_domain_presets "https://github.com/angeloscode/next-arch/tree/master/packages/next-arch/templates/pages"

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_entry,node_init,node_page,node_generate,node_doctor,node_remove,node_doctor_checks,node_import_scan toneBlue
class node_init_options,node_package_choices,node_project_scaffold,node_page_templates,node_template_renderer toneAmber
class node_plugin_entry,node_layer_model,node_import_visitors,node_boundary_rules,node_public_api_rule,node_client_server_rule,node_feature_rule toneMint
class node_app_layers,node_domain_presets toneRose
class node_developer toneIndigo
```

## Components

### Project CLI

- [CLI commands](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/index.ts): `packages/next-arch/src/index.ts`
- [Initialize project](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/commands/init.ts): `packages/next-arch/src/commands/init.ts`
- [Add page preset](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/commands/page.ts): `packages/next-arch/src/commands/page.ts`
- [Generate slice](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/commands/generate.ts): `packages/next-arch/src/commands/generate.ts`
- [Check architecture](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/commands/doctor.ts): `packages/next-arch/src/commands/doctor.ts`
- [Remove slice](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/commands/remove.ts): `packages/next-arch/src/commands/remove.ts`
- [Architecture checks](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/doctor-checks.ts): `packages/next-arch/src/lib/doctor-checks.ts`
- [Importer scan](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/find-importers.ts): `packages/next-arch/src/lib/find-importers.ts`

### Scaffolding

- [Init selections](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/init-prompts.ts): `packages/next-arch/src/lib/init-prompts.ts`
- [Package templates](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/packages.ts): `packages/next-arch/src/lib/packages.ts`
- [Project template](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/copy.ts): `packages/next-arch/src/lib/copy.ts`
- [Page presets](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/page-presets.ts): `packages/next-arch/src/lib/page-presets.ts`
- [Template rendering](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/src/lib/template.ts): `packages/next-arch/src/lib/template.ts`

### Architecture linting

- [ESLint rules](https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/index.ts): `packages/eslint-plugin-next-arch/src/index.ts`
- [Layer resolution](https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/utils/layers.ts): `packages/eslint-plugin-next-arch/src/utils/layers.ts`
- [Import visitors](https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/utils/import-visitors.ts): `packages/eslint-plugin-next-arch/src/utils/import-visitors.ts`
- [Import boundaries](https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/rules/no-upward-imports.ts): `packages/eslint-plugin-next-arch/src/rules/no-upward-imports.ts`
- [Feature public API](https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/rules/no-deep-imports.ts): `packages/eslint-plugin-next-arch/src/rules/no-deep-imports.ts`
- [Server/client boundary](https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/rules/no-server-in-client.ts): `packages/eslint-plugin-next-arch/src/rules/no-server-in-client.ts`
- [Feature isolation](https://github.com/angeloscode/next-arch/blob/master/packages/eslint-plugin-next-arch/src/rules/no-cross-feature-imports.ts): `packages/eslint-plugin-next-arch/src/rules/no-cross-feature-imports.ts`

### Generated app model

- [App layers](https://github.com/angeloscode/next-arch/blob/master/packages/next-arch/templates/app/src/app/page.tsx): `packages/next-arch/templates/app/src/app/page.tsx`
- [Domain page presets](https://github.com/angeloscode/next-arch/tree/master/packages/next-arch/templates/pages): `packages/next-arch/templates/pages`

### Other components

- **Developer**

## Connections

- Developer → CLI commands: runs commands (evidence: `packages/next-arch/src/index.ts`)
- CLI commands → Initialize project: dispatches init (evidence: `packages/next-arch/src/index.ts`)
- CLI commands → Add page preset: dispatches page (evidence: `packages/next-arch/src/index.ts`)
- CLI commands → Generate slice: dispatches generate (evidence: `packages/next-arch/src/index.ts`)
- CLI commands → Check architecture: dispatches doctor (evidence: `packages/next-arch/src/index.ts`)
- CLI commands → Remove slice: dispatches remove (evidence: `packages/next-arch/src/index.ts`)
- Initialize project → Init selections: collects selections (evidence: `packages/next-arch/src/commands/init.ts`)
- Initialize project → Package templates: applies selections (evidence: `packages/next-arch/src/commands/init.ts`)
- Initialize project → Project template: copies template (evidence: `packages/next-arch/src/commands/init.ts`)
- Add page preset → Page presets: selects preset (evidence: `packages/next-arch/src/commands/page.ts`)
- Add page preset → Template rendering: renders files (evidence: `packages/next-arch/src/commands/page.ts`)
- Generate slice → Add page preset: delegates pages (evidence: `packages/next-arch/src/commands/generate.ts`)
- Check architecture → Architecture checks: runs checks (evidence: `packages/next-arch/src/commands/doctor.ts`)
- Remove slice → Importer scan: checks importers (evidence: `packages/next-arch/src/commands/remove.ts`)
- ESLint rules → Import boundaries: registers rule (evidence: `packages/eslint-plugin-next-arch/src/index.ts`)
- ESLint rules → Feature public API: registers rule (evidence: `packages/eslint-plugin-next-arch/src/index.ts`)
- ESLint rules → Server/client boundary: registers rule (evidence: `packages/eslint-plugin-next-arch/src/index.ts`)
- ESLint rules → Feature isolation: registers rule (evidence: `packages/eslint-plugin-next-arch/src/index.ts`)
- Import boundaries → Import visitors: visits imports (evidence: `packages/eslint-plugin-next-arch/src/rules/no-upward-imports.ts`)
- Import boundaries → Layer resolution: resolves layers (evidence: `packages/eslint-plugin-next-arch/src/rules/no-upward-imports.ts`)
- Feature public API → Import visitors: visits imports (evidence: `packages/eslint-plugin-next-arch/src/rules/no-deep-imports.ts`)
- Feature public API → Layer resolution: resolves feature paths (evidence: `packages/eslint-plugin-next-arch/src/rules/no-deep-imports.ts`)
- Server/client boundary → Import visitors: visits imports (evidence: `packages/eslint-plugin-next-arch/src/rules/no-server-in-client.ts`)
- Server/client boundary → Layer resolution: checks server paths (evidence: `packages/eslint-plugin-next-arch/src/rules/no-server-in-client.ts`)
- App layers → Domain page presets: scaffolds layouts
- Developer → ESLint rules: runs lint
