# nutlope/make-comics architecture

> Architecture diagram of the GitHub repository nutlope/make-comics, 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/nutlope/make-comics
- Repository: https://github.com/nutlope/make-comics

## Overview

Make Comics is a web app for creating and editing AI-generated comic books. The primary workflow is: a visitor enters a story prompt and selects a style and character images; generation produces comic artwork and story metadata; the app saves pages and images; the author can continue, redraw, delete, and export the comic. The README documents the AI models, authentication, database, image storage, and rate limiting. Some API routes and editor actions are only partially sampled, so those links are omitted where their callers are not evidenced.

Main entry points: [`lib/db-actions.ts`](https://github.com/nutlope/make-comics/blob/main/lib/db-actions.ts) (Story data actions), [`app/api/generate-comic/route.ts`](https://github.com/nutlope/make-comics/blob/main/app/api/generate-comic/route.ts) (Comic generation), [`app/story/[storySlug]/story-editor-client.tsx`](https://github.com/nutlope/make-comics/blob/main/app/story/%5BstorySlug%5D/story-editor-client.tsx) (Story editor), [`app/api/add-page/route.ts`](https://github.com/nutlope/make-comics/blob/main/app/api/add-page/route.ts) (Add or redraw page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creation["Comic creation"]
  node_landing["Creation form"]
  node_prompt["Prompt builder<br/>[prompt.ts]"]
  node_generate["Comic generation<br/>[route.ts]"]
end

subgraph group_editing["Comic editing"]
  node_storypage["Story page<br/>[page.tsx]"]
  node_editor["Story editor"]
  node_pagegen["Page generation dialog"]
  node_addpage["Add or redraw page<br/>[route.ts]"]
  node_pdf["PDF export<br/>[route.ts]"]
  node_delete["Page deletion<br/>[route.ts]"]
end

subgraph group_backend["Application services"]
  node_feedback["Feedback endpoint<br/>[route.ts]"]
  node_credits["Credit checks<br/>[route.ts]"]
  node_apikey["API key validation<br/>[route.ts]"]
  node_ratelimit["Rate limiting<br/>[rate-limit.ts]"]
end

subgraph group_persistence["Persistence and integrations"]
  node_dbactions["Story data actions<br/>[db-actions.ts]"]
  node_database[("Neon PostgreSQL<br/>[db.ts]")]
  node_schema["Data schema<br/>[schema.ts]"]
  node_s3upload["Image uploader<br/>[s3-upload.ts]"]
  node_s3[("AWS S3")]
  node_together["Together AI models"]
  node_clerk["Clerk authentication"]
  node_redis[("Upstash Redis")]
end

node_visitor(("Comic creator"))

node_visitor -->|"enters prompt"| node_landing
node_landing -->|"uses prompts"| node_prompt
node_landing -.->|"requests generation"| node_generate
node_generate -->|"generates story and art"| node_together
node_generate -->|"creates story pages"| node_dbactions
node_generate -->|"uploads artwork"| node_s3upload
node_s3upload -->|"stores images"| node_s3
node_storypage -->|"loads story"| node_dbactions
node_storypage -->|"renders editor"| node_editor
node_editor -->|"opens page dialog"| node_pagegen
node_editor -->|"requests page change"| node_addpage
node_editor -->|"requests export"| node_pdf
node_editor -.->|"requests deletion"| node_delete
node_addpage -->|"reads and updates pages"| node_dbactions
node_addpage -->|"uploads artwork"| node_s3upload
node_addpage -->|"limits free use"| node_ratelimit
node_generate -.->|"checks generation limits"| node_ratelimit
node_pdf -->|"loads comic data"| node_dbactions
node_delete -->|"deletes page"| node_dbactions
node_feedback -->|"records feedback"| node_dbactions
node_credits -->|"checks allowance"| node_ratelimit
node_dbactions -->|"reads and writes"| node_database
node_dbactions -->|"uses table definitions"| node_schema
node_ratelimit -.->|"uses rate-limit store"| node_redis
node_generate -->|"authenticates request"| node_clerk

click node_landing "https://github.com/nutlope/make-comics/blob/main/components/landing/comic-creation-form.tsx"
click node_prompt "https://github.com/nutlope/make-comics/blob/main/lib/prompt.ts"
click node_generate "https://github.com/nutlope/make-comics/blob/main/app/api/generate-comic/route.ts"
click node_storypage "https://github.com/nutlope/make-comics/blob/main/app/story/%5BstorySlug%5D/page.tsx"
click node_editor "https://github.com/nutlope/make-comics/blob/main/app/story/%5BstorySlug%5D/story-editor-client.tsx"
click node_pagegen "https://github.com/nutlope/make-comics/blob/main/components/editor/generate-page-modal.tsx"
click node_addpage "https://github.com/nutlope/make-comics/blob/main/app/api/add-page/route.ts"
click node_pdf "https://github.com/nutlope/make-comics/blob/main/app/api/download-pdf/route.ts"
click node_delete "https://github.com/nutlope/make-comics/blob/main/app/api/delete-page/route.ts"
click node_feedback "https://github.com/nutlope/make-comics/blob/main/app/api/feedback/route.ts"
click node_credits "https://github.com/nutlope/make-comics/blob/main/app/api/check-credits/route.ts"
click node_apikey "https://github.com/nutlope/make-comics/blob/main/app/api/validate-api-key/route.ts"
click node_ratelimit "https://github.com/nutlope/make-comics/blob/main/lib/rate-limit.ts"
click node_dbactions "https://github.com/nutlope/make-comics/blob/main/lib/db-actions.ts"
click node_database "https://github.com/nutlope/make-comics/blob/main/lib/db.ts"
click node_schema "https://github.com/nutlope/make-comics/blob/main/lib/schema.ts"
click node_s3upload "https://github.com/nutlope/make-comics/blob/main/lib/s3-upload.ts"

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_landing,node_prompt,node_generate toneBlue
class node_storypage,node_editor,node_pagegen,node_addpage,node_pdf,node_delete toneAmber
class node_feedback,node_credits,node_apikey,node_ratelimit toneMint
class node_dbactions,node_database,node_schema,node_s3upload,node_s3,node_together,node_clerk,node_redis toneRose
class node_visitor toneIndigo
```

## Components

### Comic creation

- [Creation form](https://github.com/nutlope/make-comics/blob/main/components/landing/comic-creation-form.tsx): `components/landing/comic-creation-form.tsx`
- [Prompt builder](https://github.com/nutlope/make-comics/blob/main/lib/prompt.ts): `lib/prompt.ts`
- [Comic generation](https://github.com/nutlope/make-comics/blob/main/app/api/generate-comic/route.ts): `app/api/generate-comic/route.ts`

### Comic editing

- [Story page](https://github.com/nutlope/make-comics/blob/main/app/story/%5BstorySlug%5D/page.tsx): `app/story/[storySlug]/page.tsx`
- [Story editor](https://github.com/nutlope/make-comics/blob/main/app/story/%5BstorySlug%5D/story-editor-client.tsx): `app/story/[storySlug]/story-editor-client.tsx`
- [Page generation dialog](https://github.com/nutlope/make-comics/blob/main/components/editor/generate-page-modal.tsx): `components/editor/generate-page-modal.tsx`
- [Add or redraw page](https://github.com/nutlope/make-comics/blob/main/app/api/add-page/route.ts): `app/api/add-page/route.ts`
- [PDF export](https://github.com/nutlope/make-comics/blob/main/app/api/download-pdf/route.ts): `app/api/download-pdf/route.ts`
- [Page deletion](https://github.com/nutlope/make-comics/blob/main/app/api/delete-page/route.ts): `app/api/delete-page/route.ts`

### Application services

- [Feedback endpoint](https://github.com/nutlope/make-comics/blob/main/app/api/feedback/route.ts): `app/api/feedback/route.ts`
- [Credit checks](https://github.com/nutlope/make-comics/blob/main/app/api/check-credits/route.ts): `app/api/check-credits/route.ts`
- [API key validation](https://github.com/nutlope/make-comics/blob/main/app/api/validate-api-key/route.ts): `app/api/validate-api-key/route.ts`
- [Rate limiting](https://github.com/nutlope/make-comics/blob/main/lib/rate-limit.ts): `lib/rate-limit.ts`

### Persistence and integrations

- [Story data actions](https://github.com/nutlope/make-comics/blob/main/lib/db-actions.ts): `lib/db-actions.ts`
- [Neon PostgreSQL](https://github.com/nutlope/make-comics/blob/main/lib/db.ts): `lib/db.ts`
- [Data schema](https://github.com/nutlope/make-comics/blob/main/lib/schema.ts): `lib/schema.ts`
- [Image uploader](https://github.com/nutlope/make-comics/blob/main/lib/s3-upload.ts): `lib/s3-upload.ts`
- **AWS S3**
- **Together AI models**
- **Clerk authentication**
- **Upstash Redis**

### Other components

- **Comic creator**

## Connections

- Comic creator → Creation form: enters prompt
- Creation form → Prompt builder: uses prompts (evidence: `components/landing/comic-creation-form.tsx`)
- Creation form → Comic generation: requests generation
- Comic generation → Together AI models: generates story and art
- Comic generation → Story data actions: creates story pages (evidence: `app/api/generate-comic/route.ts`)
- Comic generation → Image uploader: uploads artwork (evidence: `app/api/generate-comic/route.ts`)
- Image uploader → AWS S3: stores images
- Story page → Story data actions: loads story (evidence: `app/story/[storySlug]/page.tsx`)
- Story page → Story editor: renders editor (evidence: `app/story/[storySlug]/page.tsx`)
- Story editor → Page generation dialog: opens page dialog (evidence: `app/story/[storySlug]/story-editor-client.tsx`)
- Story editor → Add or redraw page: requests page change (evidence: `app/story/[storySlug]/story-editor-client.tsx`)
- Story editor → PDF export: requests export (evidence: `app/story/[storySlug]/story-editor-client.tsx`)
- Story editor → Page deletion: requests deletion
- Add or redraw page → Story data actions: reads and updates pages (evidence: `app/api/add-page/route.ts`)
- Add or redraw page → Image uploader: uploads artwork (evidence: `app/api/add-page/route.ts`)
- Add or redraw page → Rate limiting: limits free use (evidence: `app/api/add-page/route.ts`)
- Comic generation → Rate limiting: checks generation limits (evidence: `app/api/generate-comic/route.ts`)
- PDF export → Story data actions: loads comic data (evidence: `app/api/download-pdf/route.ts`)
- Page deletion → Story data actions: deletes page (evidence: `app/api/delete-page/route.ts`)
- Feedback endpoint → Story data actions: records feedback (evidence: `app/api/feedback/route.ts`)
- Credit checks → Rate limiting: checks allowance (evidence: `app/api/check-credits/route.ts`)
- Story data actions → Neon PostgreSQL: reads and writes (evidence: `lib/db-actions.ts`)
- Story data actions → Data schema: uses table definitions (evidence: `lib/db-actions.ts`)
- Rate limiting → Upstash Redis: uses rate-limit store
- Comic generation → Clerk authentication: authenticates request (evidence: `app/api/generate-comic/route.ts`)
