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

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/danixsofyan/nextpress with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/danixsofyan/nextpress'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

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

HTML

<a href="/listings/danixsofyan--nextpress"><img src="/api/listings/danixsofyan--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/danixsofyan/nextpress.git
cd nextpress
pnpm install

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

DATABASE_URL=... pnpm db:migrate
pnpm dev

- Public site: http://localhost:3000 - Documentation: http://localhost:3000/docs (with `NEXTPRESS_DOCS=true`) - 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 · 365 lines
  1. # NextPress
  2. [![CI](https://github.com/danixsofyan/nextpress/actions/workflows/ci.yml/badge.svg)](https://github.com/danixsofyan/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 administration, 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. **Live demo:** https://nextpress-app.vercel.app · **Docs:** https://nextpress-app.vercel.app/docs ([source](docs/))
  7. ## Features
  8. ### Admin panel
  9. One app, one deployment: the admin panel lives at `/admin` on the same domain, like `/wp-admin`.
  10. - **First-run setup**: the first visit to `/admin` creates the administrator account, then public sign-up closes
  11. - **Dashboard** with content stats and a **Visit site** link
  12. - **Post editor** modeled on WordPress:
  13. - Tiptap rich-text editor
  14. - Permalink bar with inline slug editing
  15. - Publish box: status, visibility (public, private, sticky), scheduled publish date, preview, save draft, move to trash
  16. - Revisions panel to restore earlier versions
  17. - Categories and tags panels, with new tags created inline
  18. - SEO panel with Google snippet preview and keyphrase highlighting
  19. - Screen Options to show or hide panels, remembered per browser
  20. - **Pages**, **Media library**, **Menus**, **Categories & tags**
  21. - **Comments** with moderation (Pending, Approved, Spam, Trash), bulk actions, and **Settings → Discussion**
  22. - **Lists everywhere** share one data table: search, status filters with counts, sortable columns, pagination, select all, and bulk actions. Search, filter, and page live in the URL, so views can be bookmarked
  23. - **Users** with roles (Administrator, Editor, Author), add/edit/delete, password generator with strength meter, and a **Profile** page for every user
  24. - **Settings** (each tab has its own URL, e.g. `/admin/settings?tab=reading`):
  25. - **General**: site title, tagline, timezone, date and time formats (WordPress format characters)
  26. - **Discussion**: allow comments, hold comments for approval
  27. - **Reading**: latest posts or a static homepage, posts per page, feed length, full text or excerpt in feeds, discourage search engines
  28. - **Branding**: custom logo, site icon (favicon), default social (Open Graph) image
  29. - **SEO**: default meta description, custom `robots.txt`
  30. - **Privacy**: create or choose a Privacy Policy page, linked in the site footer
  31. - **API**: create, list, and revoke API keys
  32. - **Tools → Import**: WordPress export files (WXR) and RSS/Atom feeds (Blogger, Medium, Substack, Ghost, and others)
  33. - **Tools → Export**: download all content, posts, or pages as a WordPress export file (WXR)
  34. - **Appearance → Themes**: switch themes, or open a live preview of another theme that only you see
  35. - **Appearance → Customize**: colors, font, and corner radius per theme with a live preview, Reset, and Export/Import JSON. Saved in the database and applied without a deploy
  36. - **Appearance → Widgets**: blog sidebar and footer widgets (Search, Recent Posts, Categories, Tag Cloud, Text, Links), reordered with up and down buttons
  37. - **Plugins**: activate, deactivate, and configure plugins (Google Analytics 4, Meta Pixel, Cloudflare Turnstile, Google reCAPTCHA, Sign in with Google), filtered by All, Active, and Inactive
  38. - **Trash** for posts and pages with restore and permanent delete, an append-only **audit log**, and a **Donations** list with donor names and messages
  39. - **Content and Blocks panels** in the page editor collapse independently
  40. - Light / dark / system admin color scheme
  41. ### Public site
  42. - Blog with pagination, single post pages, and pages at `/{slug}`
  43. - Category, tag, and author archives (`/category/{slug}`, `/tag/{slug}`, `/author/{id}`), bylines, and site search at `/search`
  44. - Dark mode by default with a light toggle remembered per visitor, plus blog sidebar and footer widgets
  45. - Developer documentation at `/docs` when `NEXTPRESS_DOCS=true`, rendered from the Markdown files in `docs/` (the same files GitHub shows)
  46. - **Block-based pages**: hero, features, steps, stats, code, table, FAQ, call to action, latest posts, donations, Lottie animation, reusable patterns, and rich text, rendered by the active theme. Any page, including the homepage, can be a landing page
  47. - Admin bar for signed-in users (Dashboard, New, Edit Post, Log out)
  48. - Dynamic Open Graph images at `/og`, canonical URLs, and `BlogPosting`, `BreadcrumbList`, `FAQPage`, and `WebSite` JSON-LD
  49. - RSS feed at `/feed.xml`, `sitemap.xml` (posts, pages, categories, tags, docs), and `robots.txt` that welcomes AI crawlers
  50. - Built for AI answer engines (GEO/AEO): `llms.txt` and `llms-full.txt` generated from your content, and a Markdown copy of every post at `/blog/<slug>.md`
  51. ### API & AI
  52. - REST API with an OpenAPI 3.0 spec and an interactive [Scalar](https://scalar.com) reference at `/api/docs`
  53. - MCP server (Streamable HTTP) so AI agents can write posts **and build whole landing pages** from blocks, set the homepage, the navigation, and the site identity
  54. - API keys managed in the admin, stored hashed, with last-used tracking
  55. ### Security
  56. - Role-based access on every admin page and admin API route
  57. - Session cookies are `HttpOnly`, `SameSite=Strict`, and `Secure` over HTTPS
  58. - Post and page HTML is sanitized on write, whether it comes from the editor, the REST API, MCP, or an import
  59. - Login and sign-up are rate limited
  60. - Content Security Policy, HSTS, and `X-Frame-Options` on every response; admin responses are `no-store` and `noindex`
  61. - Optional isolated admin domain via `ADMIN_URL`
  62. - Row level security enabled on every table, so the Supabase Data API cannot read NextPress data
  63. See [SECURITY.md](SECURITY.md) for the security model and how to report a vulnerability.
  64. ## Themes, blocks, and AI
  65. NextPress separates three concerns so that an AI agent can design pages without breaking your site:
  66. | Layer | Who writes it | What it controls |
  67. | ---------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
  68. | **Theme** | Developers (React) | How everything looks: layout, typography, how each block renders |
  69. | **Style** | Administrators or AI agents | Colors, font, and corner radius of the active theme, set in Appearance → Customize |
  70. | **Blocks** | Editors or AI agents (JSON) | What a page contains: an ordered list of hero, features, steps, stats, code, table, FAQ, CTA, posts, and rich-text blocks |
  71. | **MCP** | AI agents | The hands: create pages from blocks, set the homepage and navigation, publish posts |
  72. AI agents never write raw HTML, CSS, or JavaScript into your site. Blocks are validated (links must be `/`, `#`, `http(s)://`, or `mailto:`; icons come from a fixed set), rich text is sanitized, and every theme renders the same blocks in its own style. Switch themes and every AI-built page restyles itself.
  73. ### Build a landing page with an AI agent
  74. Connect your agent (see below), then ask it something like:
  75. > Build a landing page for my bakery with a hero, three features, opening hours as a table, an FAQ, and a call to action. Make it the homepage and add Blog and Contact to the navigation.
  76. The agent calls `get_block_spec`, then `create_page` with blocks, `set_homepage`, and `set_navigation`.
  77. ### Write articles that Google and AI answer engines can use
  78. Ask your agent something like:
  79. > Write an article answering "How long does sourdough take to rise?" for my bakery blog and publish it.
  80. The agent calls `get_writing_guide` first, so the post leads with a direct answer, uses question headings, lists, and tables, and ends with a short FAQ. NextPress then handles the technical side automatically:
  81. | For | What NextPress adds |
  82. | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
  83. | Google (SEO) | Canonical URL, meta tags, Open Graph image, `BlogPosting` and `BreadcrumbList` JSON-LD, sitemap with last-modified dates |
  84. | Answer engines (AEO) | `FAQPage` JSON-LD built from question headings and FAQ blocks, so answers can be quoted directly |
  85. | Generative engines (GEO) | `llms.txt`, `llms-full.txt`, and `/blog/<slug>.md` serve clean Markdown to ChatGPT, Claude, Perplexity, and other AI crawlers, which `robots.txt` allows |
  86. ## Roles
  87. | Capability | Administrator | Editor | Author |
  88. | --------------------------------- | :-----------: | :----: | :----: |
  89. | Posts and media | ✓ | ✓ | ✓ |
  90. | Pages, categories, tags, menus | ✓ | ✓ | |
  91. | Users, settings, API keys, import | ✓ | | |
  92. The first account is always an Administrator. The last Administrator cannot be deleted or demoted, and nobody can change their own role.
  93. ## Tech stack
  94. | Layer | Technology |
  95. | --------- | --------------------------------------------------- |
  96. | Framework | Next.js 15 App Router, React 19 |
  97. | Language | TypeScript (strict) |
  98. | Database | PostgreSQL (Supabase) + Drizzle ORM |
  99. | Auth | Better Auth (admin plugin for users and roles) |
  100. | API | Hono v4 + `@hono/zod-openapi`, Scalar API reference |
  101. | AI agents | MCP SDK (`@modelcontextprotocol/sdk`) |
  102. | Editor | Tiptap v2 |
  103. | UI | shadcn/ui + Tailwind CSS v4 |
  104. | Tooling | pnpm 11, ESLint, Prettier, Vitest |
  105. ## Project structure
  106. NextPress is a single Next.js project: one `package.json`, one deploy.
  107. ```
  108. src/
  109. app/ routes: public site, /admin, /docs, /api
  110. components/ admin and site components, ui/ (shadcn/ui)
  111. core/ Drizzle schema, database client, types, zod validators
  112. server/ REST API (Hono + OpenAPI), MCP server, repositories
  113. lib/ auth, roles, settings, storage, themes registry, docs
  114. themes/
  115. engine/ ThemeConfig interface, formatDate, themeStyleVars
  116. default/ reference theme (cards, sans-serif)
  117. editorial/ magazine theme that reuses the default blocks
  118. drizzle/ SQL migrations and seed.sql
  119. docs/ documentation, also served at /docs
  120. public/ static files
  121. ```
  122. ## Quick start
  123. **Requirements:** Node.js 24+, pnpm 11+, a PostgreSQL database (for example a free Supabase project)
  124. ```bash
  125. git clone https://github.com/danixsofyan/nextpress.git
  126. cd nextpress
  127. pnpm install
  128. cp .env.example .env.local
  129. # Fill in the values (see Environment variables below)
  130. DATABASE_URL=... pnpm db:migrate
  131. pnpm dev
  132. ```
  133. - Public site: http://localhost:3000
  134. - Documentation: http://localhost:3000/docs (with `NEXTPRESS_DOCS=true`)
  135. - Admin panel: http://localhost:3000/admin (the first visit creates your administrator account)
  136. ## Environment variables
  137. All variables are documented in [`.env.example`](.env.example). Site title, logo, timezone, and other site options are set in the admin under Settings, not in the environment.
  138. | Variable | Required | Description |
  139. | ----------------------- | --------- | -------------------------------------------------------------------------------------------------------- |
  140. | `DATABASE_URL` | yes | PostgreSQL connection string |
  141. | `NEXT_PUBLIC_SITE_URL` | yes | Public URL of the site, no trailing slash |
  142. | `BETTER_AUTH_SECRET` | yes | Session signing secret, at least 32 characters |
  143. | `NEXT_PUBLIC_SITE_NAME` | no | Fallback site name until a Site Title is saved, default `NextPress` |
  144. | `NEXTPRESS_API_KEY` | no | Extra API key from the environment; keys are normally created in the admin |
  145. | `NEXTPRESS_DOCS` | no | `true` serves this repository's developer documentation at `/docs`, default `false` |
  146. | `SUMOPOD_API_KEY` | no | Enables the `donate` block (QRIS donations through SumoPod) |
  147. | `ADMIN_URL` | no | Serve the admin panel only on its own domain |
  148. | `REDIS_URL` | no | Shared rate limiting across instances |
  149. | `STORAGE_DRIVER` | no | `local` (default, development) or `s3` |
  150. | `S3_ENDPOINT` | with `s3` | S3 endpoint without bucket |
  151. | `S3_REGION` | no | `auto` (default) for R2, bucket region for AWS |
  152. | `S3_BUCKET` | with `s3` | Bucket name |
  153. | `S3_ACCESS_KEY_ID` | with `s3` | Access key |
  154. | `S3_SECRET_ACCESS_KEY` | with `s3` | Secret key |
  155. | `S3_PUBLIC_URL` | no | Public bucket URL. Leave empty to keep the bucket private and serve files from `/media/…` on your domain |
  156. | `MAX_UPLOAD_SIZE_MB` | no | Upload limit, default `4` |
  157. Generate secrets with `openssl rand -base64 32`.
  158. ### Isolated admin domain
  159. 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:
  160. | URL | Result |
  161. | ----------------------- | ----------- |
  162. | `yourdomain.com/` | Public site |
  163. | `yourdomain.com/admin` | 404 |
  164. | `admin.yourdomain.com/` | Admin panel |
  165. Session cookies are then bound to the admin domain, so the public site and the admin panel no longer share an origin.
  166. ### Stateless by design
  167. No instance keeps state on its own server, so every instance is disposable and you can scale horizontally:
  168. - Content, users, sessions, and settings live in PostgreSQL.
  169. - Media lives in any S3-compatible storage (Cloudflare R2, AWS S3, MinIO, Supabase Storage, Backblaze B2). The bucket can stay private: files are served from your own domain at `/media/…` with long-lived CDN caching.
  170. - Rate limits live in Redis when `REDIS_URL` is set.
  171. - `GET /api/health` checks the database and Redis, for load balancers and uptime monitors.
  172. ## Scripts
  173. | Command | Description |
  174. | ------------------ | -------------------------------------------------------------------------------------------------------------------------- |
  175. | `pnpm dev` | Run the site, admin panel, and docs at http://localhost:3000 |
  176. | `pnpm build` | Production build |
  177. | `pnpm start` | Serve the production build |
  178. | `pnpm typecheck` | Type-check |
  179. | `pnpm test` | Run unit tests with Vitest |
  180. | `pnpm lint` | Lint with ESLint (Next.js core web vitals + TypeScript) |
  181. | `pnpm format` | Format with Prettier (`pnpm format:check` only checks) |
  182. | `pnpm db:generate` | Generate a migration from schema changes |
  183. | `pnpm db:migrate` | Apply migrations (needs `DATABASE_URL`) |
  184. | `pnpm db:seed` | Add default categories, tags, and settings (safe to rerun) |
  185. | `pnpm db:roles` | Create or update the least-privilege `nextpress_app` role and its RLS policies (`DATABASE_URL` = owner, `APP_DB_PASSWORD`) |
  186. ## Deploy to Vercel
  187. 1. Import this repository as a Vercel project. No root directory or build settings are needed.
  188. 2. Add the environment variables from the table above, with `STORAGE_DRIVER=s3`.
  189. 3. Prepare the production database with the owner connection string:
  190. - `DATABASE_URL=<owner> pnpm db:migrate`
  191. - `DATABASE_URL=<owner> pnpm db:seed`
  192. - `DATABASE_URL=<owner> APP_DB_PASSWORD=<random 24+ chars> pnpm db:roles`
  193. Then set the app's `DATABASE_URL` to the pooler URL of the `nextpress_app` role (Supabase: user `nextpress_app.<project-ref>` on the transaction pooler, port 6543), and pick a Vercel function region next to the database in `vercel.json`.
  194. 4. Deploy, then open `/admin` right away to create your administrator account.
  195. Vercel detects Next.js and pnpm automatically. Run `pnpm db:migrate` again whenever an update adds a migration.
  196. ## API & MCP
  197. | Endpoint | Description |
  198. | ------------------- | ------------------------------------------------ |
  199. | `/docs` | Documentation (rendered from the `docs/` folder) |
  200. | `/api/docs` | Interactive API reference (Scalar) |
  201. | `/api/openapi.json` | OpenAPI 3.0 spec |
  202. | `/api/mcp` | MCP server (Streamable HTTP) |
  203. | `/api/health` | Health check (no API key needed) |
  204. | `/feed.xml` | RSS 2.0 feed |
  205. Create a key in **Admin → Settings → API** (`/admin/settings?tab=api`) and send it as `X-Api-Key: <key>` with every API and MCP request. Keys are stored hashed, shown once, and can be revoked at any time.
  206. ### MCP tools
  207. | Tool | What it does |
  208. | ------------------------------------------------------ | --------------------------------------------------------------------------- |
  209. | `get_writing_guide` | How to write posts that rank in Google and get quoted by AI answer engines |
  210. | `get_block_spec` | Describes every block type, its fields, icons, and examples |
  211. | `list_pages`, `get_page` | Read pages and their blocks |
  212. | `create_page`, `update_page`, `delete_page` | Build and edit pages from blocks |
  213. | `set_homepage` | Show the latest posts or a page on the homepage |
  214. | `set_navigation` | Replace the header navigation |
  215. | `get_widgets`, `set_widgets` | Read and replace the blog sidebar and footer widgets |
  216. | `update_site_identity` | Site title, tagline, default meta description |
  217. | `create_post`, `update_post`, `list_posts`, `get_post` | Write and manage blog posts |
  218. | `create_taxonomy` | Create categories and tags |
  219. | `list_themes`, `set_theme`, `update_theme_style` | List installed themes, activate one, customize its colors, font, and radius |
  220. | `get_site_config`, `get_theme_spec` | Read settings and the theme interface |
  221. ### Connect an MCP client
  222. ```json
  223. {
  224. "mcpServers": {
  225. "nextpress": {
  226. "url": "https://your-site.com/api/mcp",
  227. "headers": { "X-Api-Key": "your-key" }
  228. }
  229. }
  230. }
  231. ```
  232. ## Building a theme
  233. A theme is a folder in `src/themes/` that exports a `ThemeConfig` from `@/themes/engine`:
  234. ```ts
  235. import { Blocks } from '@/themes/default'
  236. import { defineTheme } from '@/themes/engine'
  237. export const theme = defineTheme({
  238. name: 'my-theme',
  239. label: 'My Theme',
  240. description: 'What makes this theme different',
  241. version: '1.0.0',
  242. defaultStyle: {
  243. primary: '#0f172a',
  244. background: '#ffffff',
  245. foreground: '#0f172a',
  246. accent: '#f1f5f9',
  247. font: 'sans',
  248. radius: 'medium',
  249. },
  250. supports: ['blog'],
  251. slots: {
  252. Layout,
  253. Header,
  254. Footer,
  255. PostCard,
  256. PostList,
  257. PostDetail,
  258. Blocks,
  259. CategoryPage,
  260. TagPage,
  261. HomePage,
  262. },
  263. })
  264. ```
  265. Themes are code, so a new theme ships with the repository: copy a theme folder in `src/themes/`, register it in `THEMES` in `src/lib/themes.ts`, and deploy. It then appears in **Appearance → Themes**. Theme code is never uploaded at runtime, because running uploaded code would let anyone with admin access execute anything on the server. Styles are data, so they change without a deploy.
  266. See the [theme development guide](docs/theme-development.md), or call the MCP tool `get_theme_spec` for the full interface schema.
  267. ## Plugins
  268. Plugins add integrations such as analytics and ad pixels. Like themes, they ship as code in `src/plugins/<id>` and are registered in `src/plugins/index.ts`; administrators activate and configure them under **Plugins** without a deploy. Secrets stay in environment variables. Bundled plugins: Google Analytics 4, Meta Pixel, Cloudflare Turnstile and Google reCAPTCHA (sign-in and donation form protection), and Sign in with Google for existing admin users.
  269. See the [plugin development guide](docs/plugin-development.md) and [ADR 0009](docs/adr/0009-plugins-ship-as-code.md).
  270. ## Contributing
  271. Read [AGENTS.md](AGENTS.md) and the [engineering standard](docs/engineering-standard.md) first. They apply to humans and AI agents alike. The [quality bar](docs/quality.md) shows what is measured and what is still open, and [docs/adr/](docs/adr/) explains the main design decisions.
  272. 1. Fork the repository
  273. 2. Create a branch: `git checkout -b feature/your-feature`
  274. 3. Make sure `pnpm lint`, `pnpm format:check`, `pnpm typecheck`, and `pnpm test` pass
  275. 4. Commit using [Conventional Commits](https://www.conventionalcommits.org): `feat: add X`
  276. 5. Open a pull request using the template, and add an entry to [CHANGELOG.md](CHANGELOG.md)
  277. ## Author
  278. NextPress is created and maintained by **Dani Sofyan** ([@danixsofyan](https://github.com/danixsofyan)). Contributions are welcome.
  279. ## License
  280. [MIT](LICENSE) © 2026 Dani Sofyan and NextPress contributors
  281. The landing-page animation in `public/lottie/globe.json` is "Earth and connections" from [LottieFiles](https://lottiefiles.com/free-animation/earth-and-connections-qKp1xwkNHV), used under the [Lottie Simple License](https://lottiefiles.com/page/license).

Ratings and comments

Sign in to rate this skill.

Sign in

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