FinScope is a modern, static-first finance blog built with Next.js 15 (App Router), Tailwind CSS, and MDX. It is designed for high performance, maximum SEO, and seamless deployment on Cloudflare Pages.

• Static Site Generation (SSG): Pre-rendered pages for lightning-fast load times.
• MDX Support: Write content in Markdown with embedded React components.
• SEO Optimized: Dynamic metadata, JSON-LD schema, and sitemap generation.
• Responsive Design: Built with Tailwind CSS v4 (alpha/beta) concepts.
• Client-Side Interactive Elements: Table of Contents, Breadcrumbs, etc.
• AdSense Ready: Placeholder slots for strategic ad placement.

• Framework: Next.js 15
• Styling: Tailwind CSS
• Content: MDX (via next-mdx-remote)
• Icons: Lucide React
• Deployment: Cloudflare Pages

• Node.js 18+
• npm or yarn or pnpm or bun

1. Clone the repository:

   git clone https://github.com/your-username/finscope.git
   cd finscope

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

4. Open http://localhost:3000 with your browser.

Content is managed via MDX files located in the content/ directory.

content/
├── credit-cards/
│   ├── best-student-cards.mdx
│   └── axis-magnus-review.mdx
├── personal-loans/
└── ...

Each MDX file must start with the following frontmatter:

---
title: "Article Title"
slug: "url-friendly-slug"
description: "Short description for SEO."
category: "credit-cards" # Must match directory name
author: "Author Name"
publishedAt: "YYYY-MM-DD"
updatedAt: "YYYY-MM-DD"
keywords:
  - "keyword 1"
  - "keyword 2"
---

This project is configured for Cloudflare Pages.

1. Build:

   npm run build

   This generates a static out/ directory.

2. Deploy (Manual):

   npx wrangler pages deploy out --project-name finscope

3. CI/CD: Connect your GitHub repository to Cloudflare Pages for automatic deployments on push.

This project is licensed under the MIT License.