NxthPress is an open-source, block-based CMS built with Next.js (App Router), Prisma + PostgreSQL, Auth.js v5, and Tailwind CSS.
It uses React Server Components by default (with Client Components only where needed), and features a modular page builder, blog engine, and live SEO previews.

• Features
• Tech Stack
• Quick Start
• Environment Variables
• Page Builder
• Blog
• Development Scripts
• Deployment
• Contributing
• License

• ⚡ Server Actions for CRUD (no API routes)
• 🧱 Page Builder with pluggable blocks + live SEO preview
• ✍️ Blog system with tags, pagination, Markdown, and per-post SEO
• 🔍 Draft Preview Mode with token-based access
• ☁️ Cloudinary integration for file/image uploads
• 🐳 Docker Compose setup for PostgreSQL
• 🎨 Built with Tailwind CSS 4
• 🚀 Optimized for Vercel deployment (ISR enabled by default)

# clone the repo
git clone https://github.com/shalomtaiwo/nxthpress.git
cd nxthpress

# copy and edit env vars
cp .env.example .env

# install dependencies
pnpm install

# setup database
pnpm db:up
pnpm prisma:migrate
pnpm prisma:generate
pnpm prisma:seed   # optional demo content

# run development server
pnpm dev

Now visit http://localhost:3000.

Copy .env.example → .env and set values:

• 📂 Location: src/components/page-builder/
• 🧩 Blocks included: FeatureGrid, TwoColumn, Testimonial, FAQ, CTA Banner, Video Embed, SEO, and more
• ✏️ Editing: PageBuilder.tsx (Client Component) manages block JSON arrays and outputs via hidden <input name="blocks">
• 🎨 Rendering: PageRenderer.tsx (Server Component) maps block types to renderers in src/components/page-renderer/
• 🔧 Extending: Add new blocks by creating:
  • an editor in page-builder/editors/
  • a renderer in page-renderer/blocks/
  • register both in their registry.ts files

• 🗂 Routes:
  • /blog → blog index (with pagination + optional ?tag= filter)
  • /blog/[slug] → individual post
• 📝 Content: Markdown via react-markdown, remark-gfm, and rehype-raw
• ⚙️ Admin Panel:
  • CRUD under /admin/posts
  • Rich Markdown editor
  • Tag management
  • Cloudinary cover-image uploads
• 📈 SEO: per-post metadata (seoTitle, seoDescription, seoImageUrl) with live preview

• Use a managed PostgreSQL (e.g., Supabase, Neon, RDS) or self-hosted instance
• Set all required environment variables on your host
• Run prisma migrate deploy during deployment to apply schema changes
• Recommended: Vercel (ISR enabled, revalidate = 60)

Contributions are welcome!
Feel free to open issues or submit PRs to improve NxthPress.

MIT License © 2025 NxthPress contributors.