🌟 Neo-Blog: Nirmal's Modern Blogger Site

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.

🚀 Tech Stack

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

🎯 Key Features

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.

📖 Comprehensive Documentation

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!)

🗂️ Project Structure

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)

🏗️ Local Development

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.

✍️ Writing a Blog Post

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!

📫 Connect with me

“Code is like humor. When you have to explain it, it’s bad.”