How nutlope/make-comics works
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: db-actions.ts Story data actions · generate-comic/route.ts Comic generation · story-editor-client.tsx Story editor · add-page/route.ts Add or redraw page
Components 22
Comic creation
- Creation form
components/landing/comic-creation-form.tsx - Prompt builder
lib/prompt.ts - Comic generation
app/api/generate-comic/route.ts
Comic editing
- Story page
app/story/[storySlug]/page.tsx - Story editor
app/story/[storySlug]/story-editor-client.tsx - Page generation dialog
components/editor/generate-page-modal.tsx - Add or redraw page
app/api/add-page/route.ts - PDF export
app/api/download-pdf/route.ts - Page deletion
app/api/delete-page/route.ts
Application services
- Feedback endpoint
app/api/feedback/route.ts - Credit checks
app/api/check-credits/route.ts - API key validation
app/api/validate-api-key/route.ts - Rate limiting
lib/rate-limit.ts
Persistence and integrations
- Story data actions
lib/db-actions.ts - Neon PostgreSQL
lib/db.ts - Data schema
lib/schema.ts - Image uploader
lib/s3-upload.ts - AWS S3
- Together AI models
- Clerk authentication
- Upstash Redis
Other components
- Comic creator
Connections 25
- Comic creator → Creation form: enters prompt
- Creation form → Prompt builder: uses prompts
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
app/api/generate-comic/route.ts - Comic generation → Image uploader: uploads artwork
app/api/generate-comic/route.ts - Image uploader → AWS S3: stores images
- Story page → Story data actions: loads story
app/story/[storySlug]/page.tsx - Story page → Story editor: renders editor
app/story/[storySlug]/page.tsx - Story editor → Page generation dialog: opens page dialog
app/story/[storySlug]/story-editor-client.tsx - Story editor → Add or redraw page: requests page change
app/story/[storySlug]/story-editor-client.tsx - Story editor → PDF export: requests export
app/story/[storySlug]/story-editor-client.tsx - Story editor → Page deletion: requests deletion
- Add or redraw page → Story data actions: reads and updates pages
app/api/add-page/route.ts - Add or redraw page → Image uploader: uploads artwork
app/api/add-page/route.ts - Add or redraw page → Rate limiting: limits free use
app/api/add-page/route.ts - Comic generation → Rate limiting: checks generation limits
app/api/generate-comic/route.ts - PDF export → Story data actions: loads comic data
app/api/download-pdf/route.ts - Page deletion → Story data actions: deletes page
app/api/delete-page/route.ts - Feedback endpoint → Story data actions: records feedback
app/api/feedback/route.ts - Credit checks → Rate limiting: checks allowance
app/api/check-credits/route.ts - Story data actions → Neon PostgreSQL: reads and writes
lib/db-actions.ts - Story data actions → Data schema: uses table definitions
lib/db-actions.ts - Rate limiting → Upstash Redis: uses rate-limit store
- Comic generation → Clerk authentication: authenticates request
app/api/generate-comic/route.ts