This repository is deprecated. Architecture documentation is now generated via the Supermodel CLI using the supermodel docs command.

Generate architecture documentation for any repository using Supermodel. Produces a full static site with search, SEO, taxonomy navigation, interactive charts, and dependency graphs.

If this is useful, please star our tools — it helps us grow:

name: Architecture Docs
on:
  push:
    branches: [main]

jobs:
  docs:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: supermodeltools/arch-docs@main
        id: docs
        with:
          supermodel-api-key: ${{ secrets.SUPERMODEL_API_KEY }}

      - uses: actions/upload-pages-artifact@v3
        with:
          path: ${{ steps.docs.outputs.site-path }}

      - uses: actions/deploy-pages@v4

1. Zips the repository (skipping .git/, node_modules/, binaries, large files)
2. Sends the zip to the Supermodel API for code analysis
3. Receives a graph JSON with nodes (files, functions, classes, domains) and relationships
4. Runs graph2md to convert the graph to markdown
5. Runs pssg to build a static site with the bundled templates

To customize the look of the generated site, create a templates/ directory in your repository with your own HTML templates and pass it via the templates-dir input:

- uses: supermodeltools/arch-docs@main
  with:
    supermodel-api-key: ${{ secrets.SUPERMODEL_API_KEY }}
    templates-dir: './my-templates'

See the bundled templates/ directory for the default templates and available template variables.

The generated site includes:

• Homepage with architecture overview chart and codebase composition treemap
• Entity pages with dependency diagrams, relationship graphs, and source code
• Taxonomy pages for node types, languages, domains, subdomains, directories, extensions, and tags
• Full-text search with keyboard navigation
• SEO metadata, Open Graph tags, JSON-LD structured data, sitemap, and RSS feed