MDXpress

🚀 MDXpress Blog - CNP (Compiled N' Portable)

MDXpress Blog - CNP is a serverless-friendly version of the original MDXpress Blog, reworked to deploy seamlessly on platforms like Vercel using Serverless Functions.

It’s a markdown-powered, minimal blogging platform that compiles content on-the-fly without any backend server, database, or complex setup.

✨ What's New in CNP?

• ✅ Serverless Architecture: Powered by Vercel Serverless Functions.
• 🪄 Vercel-Ready: No server.js, works natively with vercel dev and on production deploys.
• 📁 /api Directory Support: Each route is handled through functions inside the /api/ folder.
• ⚙️ Markdown Compilation: Still powered by marked, now running serverlessly.
• 💅 Same UI, Better Delivery: No compromises on theming, dark mode, or user experience.

📁 Project Structure

1
mdxpress-blog-cnp/
2
├── api/                 # Serverless function handlers
3
│   ├── index.js         # Homepage rendering
4
│   ├── blog.js          # Blog listing route
5
│   └── blog/[slug].js   # Dynamic blog rendering
6
├── public/
7
│   ├── blogs/           # Markdown files for each blog post
8
│   ├── styles/          # CSS with dark mode support
9
│   └── views/           # HTML templates
10
├── vercel.json          # Vercel routing and config
11
├── package.json         # Metadata and dependencies
12
└── README.md            # This file

🧪 How to Run Locally

1. Clone the Repository

   1
   git clone https://github.com/eshan-singh78/MDXpress-Blog
   2
   cd MDXpress-Blog-CNP

2. Install Dependencies

   1
   npm install

3. Run Locally with Vercel

   1
   vercel dev

4. Visit the App Open http://localhost:3000 in your browser.

📌 How It Works on Vercel

• All backend logic is handled via Serverless Functions in /api.
• Static assets (styles, markdown files) are served from /public.
• HTML templates are combined with rendered Markdown and returned as HTML.

🙋‍♂️ About the Creator

Crafted by Eshan Singh, a full-stack developer & cybersecurity enthusiast exploring the balance of performance and simplicity in web apps.

Looking to contribute, request features, or report issues? Feel free to open a PR or issue!