Last updated: 2026-02-15
This document defines terms, concepts, and abbreviations used throughout the Running Red project.
The main character of the Running Red webcomic. Created by Ren when he was 13, developed over a decade.
A single page of the webcomic. Each page has:
- A sequential page number (1, 2, 3...)
- An image (the actual comic artwork)
- Optional title
- Optional author commentary
- Publish date
- Status (draft or published)
A flag on comic pages that contain sensitive content (violence, trauma, etc.). Pages with content warnings display blurred with a confirmation overlay before revealing.
The author and artist of Running Red. He uses the admin interface to manage the comic. He/him pronouns.
The name of the webcomic and this project. The domain is running.red.
A URL-safe identifier for a comic page. Format: page-{N} (e.g., page-1, page-42). Used in URLs like /comic/page-42.
The password-protected section of the website (/admin) where Ren manages content. Includes pages for uploading comics, editing About/Links, and site settings.
A serverless function in Next.js that handles backend logic (e.g., uploading images, database mutations). Located in app/api/.
Next.js's new routing system (introduced in v13+, stable in v15). Uses the app/ directory with file-based routing and React Server Components.
LQIP = Low-Quality Image Placeholder. A tiny, base64-encoded version of an image used as a placeholder while the full image loads. Prevents blank space, improves perceived performance.
A network of servers that cache and serve content (images, CSS, JS) from locations close to users. Cloudflare's CDN serves our R2 images.
A React component in Next.js that runs in the browser. Marked with "use client". Used for interactivity (state, events, browser APIs).
In database terms, a table with multiple rows (e.g., comic_pages). Contrast with singleton.
Next.js feature that pre-renders pages at build time (like SSG) but can revalidate and regenerate them in the background. Perfect for comic pages (static but update weekly).
Code that runs before a request is completed (in Next.js). Used to protect /admin routes (check authentication before allowing access).
Triggering ISR revalidation manually (via API call) instead of waiting for the revalidation window. Used when Ren publishes a new page.
The relational database we use to store content metadata (comic pages, about page, links, site settings). Often abbreviated as "Postgres."
Cloudflare's object storage service (S3-compatible). We use it to store comic page images. Zero egress fees = free to serve images to readers.
The process of updating a statically-generated page in Next.js. Triggered automatically (ISR with a time window) or manually (on-demand).
A React component in Next.js that runs on the server only. Default in App Router. Generates HTML, doesn't ship JavaScript to the browser.
A Node.js library for image processing (resize, convert formats, optimize). We use it to generate WebP variants and blur placeholders.
In database terms, a table with only 1 row (e.g., about_page, site_settings). Not a collection.
Pre-rendering pages at build time. Pages are generated once, served as static HTML. Fast, but doesn't update without rebuilding.
Rendering pages on every request (on the server). Always fresh, but slower than SSG.
A utility-first CSS framework. Provides classes like flex, px-4, text-blue-500 that you apply directly to HTML elements.
A modern image format developed by Google. ~30% smaller than JPEG at equivalent quality. Supported by all modern browsers.
PostgreSQL's data type for JSON data stored in binary format. Used for the links array in links_page table (flexible, queryable).
A script that changes the database schema (e.g., adding a column, creating a table). Migrations are versioned and applied in order.
A unique identifier for a row in a table (e.g., id column). Every table has one.
The structure of a database table (column names, types, constraints). Also used to refer to the overall database structure.
Initial data inserted into the database (e.g., default site settings, empty about page). Used when setting up a new database.
Architecture Decision Record. A document explaining why we made a specific architectural choice. See DECISIONS.md.
Application Programming Interface. In this project, usually refers to Next.js API routes (serverless functions).
Content Delivery Network. Cloudflare's CDN serves our R2 images fast.
Content Management System. We initially tried Payload CMS, then decided to build our own simple admin interface instead.
Cascading Style Sheets. The language for styling web pages. We use Tailwind CSS.
Developer Experience. How easy/pleasant it is to work with a tool or codebase.
HyperText Markup Language. The markup language for web pages.
Incremental Static Regeneration. Next.js feature for static pages that can update.
Low-Quality Image Placeholder. Same as blur hash.
Open Graph. The protocol for social media sharing metadata (e.g., og:title, og:image). Used by Facebook, Twitter, etc.
Pull Request. A Git workflow for reviewing code changes before merging into the main branch.
Really Simple Syndication. A web feed format that allows users to subscribe to content updates.
Search Engine Optimization. Practices to make the site more discoverable via search engines (Google, Bing, etc.).
Static Site Generation. Pre-rendering pages at build time.
Server-Side Rendering. Rendering pages on every request.
TypeScript, the typed superset of JavaScript we use for all code.
User Interface. The visual elements users interact with.
Uniform Resource Locator. The web address (e.g., https://running.red/comic/page-42).
User Experience. How users feel when using the site.
Continuous Integration / Continuous Deployment. Automated testing and deployment (e.g., GitHub Actions runs tests on every PR, Vercel auto-deploys on push).
A commit message format: type: description (e.g., feat: add content warning overlay). Types: feat, fix, docs, chore, refactor, etc.
The integration/staging branch. All PRs target develop. Merges into main for production releases.
The production branch. Code in main is deployed to running.red.
A repository with multiple apps/packages (e.g., apps/web, apps/cms, packages/shared). We don't use this anymore (we ditched the monorepo for a single app).
Vercel creates a preview URL for every PR (e.g., *.vercel.app). Useful for testing before merging.
A page (/archive) that lists all published comic pages chronologically.
The visual effect on content-warning pages: the comic image is blurred, covered with an overlay showing warning text and a "View Page" button.
Author's notes displayed below each comic page. Written by Ren, can be markdown or plain text.
The buttons below the comic image: First | Previous | Next | Last. Used to navigate between pages.
The top navigation on the public site, showing the site title and links (Home, About, Archive, Links).
The larger WebP variant (max 1200px wide) for desktop/tablet screens.
The smaller WebP variant (max 800px wide) for mobile phones.
The PNG or JPEG file Ren uploads. Stored in R2 for archival, but not served to readers (we serve WebP variants instead).
Images that load different sizes based on the user's screen size. Implemented with <picture> and srcset.
An HTML attribute that lists multiple image sources (sizes) for the browser to choose from. Used for responsive images.
The company that provides R2 (object storage) and CDN. Also handles DNS for the domain.
A platform for hosting databases and backend services. We use Railway for PostgreSQL.
The platform that hosts the Next.js app. Auto-deploys on Git push, provides preview URLs, has a generous free tier.
- ARCHITECTURE.md — Technical architecture (uses these terms)
- PRODUCT.md — Product requirements (uses these terms)
- CONVENTIONS.md — Code conventions (uses these terms)