Skip to content

eshan-singh78/MDXpress-Blog-CNP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 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

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

🧪 How to Run Locally

  1. Clone the Repository

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

    npm install
  3. Run Locally with Vercel

    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!

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors