Welcome to the repository for Neo-Blog, my personal, premium blogger and portfolio site. This application is designed to be highly performant, visually stunning, and SEO-optimized, built with modern web development standards.
- Framework: Next.js 16 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS + Radix UI (shadcn/ui)
- Icons: Lucide React
- Animations: Framer Motion
- Content: MDX (Markdown + React components)
- Deployment: Netlify
- Blazing Fast Performance: Fully statically generated (SSG) utilizing Next.js App Router for optimal load times.
- Premium Aesthetics: Clean, modern UI featuring a custom dark theme, glassmorphism effects, and vibrant gradient accents.
- Interactive Animations: Smooth micro-animations and scroll effects powered by Framer Motion.
- Markdown (MDX) Powered Blog: Write rich content effortlessly while embedding custom React components directly into blog posts.
- SEO Optimized: Structured metadata, Open Graph tags, and semantic HTML for prominent search engine visibility.
- Responsive Design: Seamless experience across mobile, tablet, and desktop devices.
Need to know how the project is structured, how to write a new blog post, or how to deploy?
Check out the full HTML Documentation →
(Simply open /Documentation/index.html in your browser to view the complete guide, including our future roadmap!)
blog/
├── Documentation/ # Comprehensive HTML/CSS/JS documentation
├── public/ # Static assets (images, icons)
│ └── images/blog/ # Blog post cover images
├── src/
│ ├── app/ # Next.js App Router pages
│ │ ├── about/ # About page route
│ │ ├── blog/ # Blog listing & individual post routes
│ │ ├── sections/ # Homepage sectional components
│ │ ├── globals.css # Global Tailwind & base styling
│ │ ├── layout.tsx # Root layout (Header, Footer, Theme)
│ │ └── page.tsx # Homepage
│ ├── components/ # Reusable React components
│ │ ├── layout/ # Header, Footer, ThemeProvider
│ │ ├── ui/ # shadcn/ui raw components
│ │ └── mdx-components # Custom renderers for MDX posts
│ ├── content/posts/ # Actual MDX blog post files live here
│ └── lib/ # Utility functions (e.g., posts parsing)
├── netlify.toml # Netlify Deployment Configuration
└── next.config.ts # Next.js build config (Image domains)
To get a local copy up and running, follow these simple steps:
- Clone the repo
git clone https://github.com/iam-neo/Neo-Blog.git
- Install NPM packages
npm install
- Run the development server
npm run dev
Open http://localhost:3000 with your browser to see the result.
Posts are written in MDX and stored in src/content/posts. Here is a quick example:
---
title: "Your Post Title"
date: "2026-02-22"
excerpt: "A short description for the listing page"
tags: ["web-dev", "react", "tutorial"]
---
Your markdown content goes here... Use **bold**, *italic*, code blocks, etc.Commit and push your new .mdx file, and Netlify will automatically build and deploy your new post!
- GitHub: @iam-neo
- Website: magarnirmal.com.np
- Email: nirmalrokamagar54@gmail.com
“Code is like humor. When you have to explain it, it’s bad.”