Skip to content
Back to search

nextpress

Open-source WordPress alternative on Next.js 15 + TypeScript. WordPress-style editor at /admin, REST API, MCP server for AI agents, S3 media, stateless and Vercel-ready.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pebisnice-org--nextpress/badge.svg)](/listings/pebisnice-org--nextpress)

HTML

<a href="/listings/pebisnice-org--nextpress"><img src="/api/listings/pebisnice-org--nextpress/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Requirements:** Node.js 24+, pnpm 11+, a PostgreSQL database (for example a free Supabase project)

git clone https://github.com/pebisnice/nextpress.git
cd nextpress
pnpm install

cp .env.example apps/web/.env.local
# Fill in the values (see Environment variables below)

pnpm db:migrate
pnpm dev

- Public site: http://localhost:3000 - Admin panel: http://localhost:3000/admin (the first visit creates your administrator account)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 214 lines
  1. # NextPress
  2. [![CI](https://github.com/pebisnice/nextpress/actions/workflows/ci.yml/badge.svg)](https://github.com/pebisnice/nextpress/actions/workflows/ci.yml)
  3. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](#license)
  4. An open-source WordPress alternative built on Next.js 15, TypeScript, and PostgreSQL. Familiar WordPress-style editing, a typed REST API, and a built-in MCP server so AI agents can manage your content.
  5. Runs free on [Vercel](https://vercel.com) + [Supabase](https://supabase.com).
  6. ## Features
  7. ### Admin panel
  8. One app, one deployment: the admin panel lives at `/admin` on the same domain, like `/wp-admin`.
  9. - **First-run setup**: the first visit to `/admin` creates the administrator account, then sign-up closes
  10. - **Dashboard** with content stats
  11. - **Post editor** modeled on WordPress:
  12. - Tiptap rich-text editor
  13. - Permalink bar with inline slug editing
  14. - Publish box: status, visibility (public / private / password), publish date, preview, save draft, move to trash
  15. - Categories and tags panels, with new tags created inline
  16. - SEO panel with Google snippet preview and keyphrase highlighting
  17. - Screen Options to show or hide panels (format, categories, tags, excerpt, SEO), remembered per browser
  18. - **Pages**, **media library**, **menus**, **categories & tags**, **site settings**
  19. - Light / dark / system theme
  20. ### Public site
  21. - Blog index and post pages from the theme system
  22. - Dynamic OpenGraph images at `/og`
  23. - `sitemap.xml`, `robots.txt`, and `llms.txt` (AI crawlers such as GPTBot, ClaudeBot, and PerplexityBot are allowed)
  24. ### API & AI
  25. - REST API with an OpenAPI 3.0 spec and Swagger UI
  26. - MCP server (Streamable HTTP) so AI agents can create and update content
  27. - API key authentication and rate limiting
  28. ### Security
  29. - Session cookies are `HttpOnly`, `SameSite=Strict`, and `Secure` over HTTPS
  30. - Post and page HTML is sanitized on write, whether it comes from the editor, the REST API, or MCP
  31. - Login and sign-up are rate limited
  32. - Content Security Policy, HSTS, and `X-Frame-Options` on every response; admin responses are `no-store` and `noindex`
  33. - Optional isolated admin domain via `ADMIN_URL` (see below)
  34. ## Tech stack
  35. | Layer | Technology |
  36. |---|---|
  37. | Framework | Next.js 15 App Router, React 19 |
  38. | Language | TypeScript (strict) |
  39. | Database | PostgreSQL (Supabase) + Drizzle ORM |
  40. | Auth | Better Auth |
  41. | API | Hono v4 + `@hono/zod-openapi` |
  42. | AI agents | MCP SDK (`@modelcontextprotocol/sdk`) |
  43. | Editor | Tiptap v2 |
  44. | UI | shadcn/ui + Tailwind CSS v4 |
  45. | Tooling | Turborepo, pnpm 11, Biome |
  46. ## Monorepo structure
  47. ```
  48. apps/
  49. web/ site + admin panel at /admin (port 3000)
  50. docs/ documentation (port 3002)
  51. packages/
  52. core/ Drizzle schema, migrations, types, validators
  53. api/ Hono routes, OpenAPI, MCP server, repositories
  54. ui/ shared shadcn/ui components
  55. config/ shared tsconfig and Biome config
  56. theme-engine/ ThemeConfig interface
  57. themes/
  58. default/ reference theme
  59. ```
  60. ## Quick start
  61. **Requirements:** Node.js 24+, pnpm 11+, a PostgreSQL database (for example a free Supabase project)
  62. ```bash
  63. git clone https://github.com/pebisnice/nextpress.git
  64. cd nextpress
  65. pnpm install
  66. cp .env.example apps/web/.env.local
  67. # Fill in the values (see Environment variables below)
  68. pnpm db:migrate
  69. pnpm dev
  70. ```
  71. - Public site: http://localhost:3000
  72. - Admin panel: http://localhost:3000/admin (the first visit creates your administrator account)
  73. ## Environment variables
  74. All variables are documented in [`.env.example`](.env.example).
  75. | Variable | Required | Description |
  76. |---|---|---|
  77. | `DATABASE_URL` | yes | PostgreSQL connection string |
  78. | `NEXT_PUBLIC_SITE_URL` | yes | Public URL of the site, no trailing slash |
  79. | `NEXT_PUBLIC_SITE_NAME` | no | Site name used in metadata, default `NextPress` |
  80. | `BETTER_AUTH_SECRET` | yes | Session signing secret, at least 32 characters |
  81. | `NEXTPRESS_API_KEY` | yes | REST API and MCP key, at least 32 characters |
  82. | `ADMIN_URL` | no | Serve the admin panel only on its own domain |
  83. | `REDIS_URL` | no | Shared rate limiting across instances |
  84. | `STORAGE_DRIVER` | no | `local` (default, development) or `s3` |
  85. | `S3_ENDPOINT` | with `s3` | S3 endpoint without bucket |
  86. | `S3_REGION` | no | `auto` (default) for R2, bucket region for AWS |
  87. | `S3_BUCKET` | with `s3` | Bucket name |
  88. | `S3_ACCESS_KEY_ID` | with `s3` | Access key |
  89. | `S3_SECRET_ACCESS_KEY` | with `s3` | Secret key |
  90. | `S3_PUBLIC_URL` | with `s3` | Public base URL that serves the bucket |
  91. | `MAX_UPLOAD_SIZE_MB` | no | Upload limit, default `4` |
  92. Generate secrets with `openssl rand -base64 32`.
  93. ### Isolated admin domain
  94. By default the admin panel is served at `/admin` on the public domain, like WordPress. For stricter setups, set `ADMIN_URL=https://admin.yourdomain.com` and point that domain at the same deployment:
  95. | URL | Result |
  96. |---|---|
  97. | `yourdomain.com/` | Public site |
  98. | `yourdomain.com/admin` | 404 |
  99. | `admin.yourdomain.com/` | Admin panel |
  100. Session cookies are then bound to the admin domain, so the public site and the admin panel no longer share an origin.
  101. ### Stateless by design
  102. No app keeps state on its own server, so every instance is disposable and you can scale horizontally:
  103. - Content and sessions live in PostgreSQL.
  104. - Media lives in any S3-compatible storage (Cloudflare R2, AWS S3, MinIO, Supabase Storage, Backblaze B2).
  105. - Rate limits live in Redis when `REDIS_URL` is set.
  106. - `GET /api/health` checks the database and Redis, for load balancers and uptime monitors.
  107. ## Scripts
  108. | Command | Description |
  109. |---|---|
  110. | `pnpm dev` | Run the site, admin panel, and docs in development mode |
  111. | `pnpm build` | Build everything |
  112. | `pnpm typecheck` | Type-check every package |
  113. | `pnpm exec biome lint .` | Lint |
  114. | `pnpm format` | Format with Biome |
  115. | `pnpm db:generate` | Generate a migration from schema changes |
  116. | `pnpm db:migrate` | Apply migrations |
  117. ## Deploy to Vercel
  118. 1. Import this repository as a Vercel project and set the root directory to `apps/web`.
  119. 2. Add the environment variables from the table above, with `STORAGE_DRIVER=s3`.
  120. 3. Run the migrations once against your production database: `DATABASE_URL=... pnpm db:migrate`
  121. 4. Deploy, then open `/admin` to create your administrator account.
  122. Vercel detects Next.js, Turborepo, and pnpm automatically.
  123. ## API & MCP
  124. | Endpoint | Description |
  125. |---|---|
  126. | `/api/docs` | Swagger UI |
  127. | `/api/openapi.json` | OpenAPI 3.0 spec |
  128. | `/api/mcp` | MCP server |
  129. | `/api/health` | Health check (no API key needed) |
  130. Send `X-Api-Key: <NEXTPRESS_API_KEY>` with every API and MCP request.
  131. ### Connect an MCP client
  132. ```json
  133. {
  134. "mcpServers": {
  135. "nextpress": {
  136. "url": "https://your-site.com/api/mcp",
  137. "headers": { "X-Api-Key": "your-key" }
  138. }
  139. }
  140. }
  141. ```
  142. ## Building a theme
  143. Themes implement the `ThemeConfig` interface from `@nextpress/theme-engine`:
  144. ```ts
  145. import { defineTheme } from "@nextpress/theme-engine"
  146. export const theme = defineTheme({
  147. name: "my-theme",
  148. version: "1.0.0",
  149. supports: ["blog"],
  150. slots: { Layout, Header, Footer, PostCard, PostDetail, CategoryPage, TagPage, HomePage },
  151. })
  152. ```
  153. See the [theme development guide](apps/docs/content/docs/theme-development/index.mdx), or call the MCP tool `get_theme_spec` for the full interface schema.
  154. ## Contributing
  155. 1. Fork the repository
  156. 2. Create a branch: `git checkout -b feat/your-feature`
  157. 3. Make sure `pnpm exec biome lint .`, `pnpm exec biome format .`, and `pnpm typecheck` pass
  158. 4. Commit using [Conventional Commits](https://www.conventionalcommits.org): `feat: add X`
  159. 5. Open a pull request
  160. ## License
  161. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.