How khalidoukoujane/b-app works
Project type and purpose
• This is a Next.js-based modern blog application (“B-App”) that uses static files (Markdown) and server-side rendering (or static generation) to deliver a performant, responsive blog.
• Purpose: Render a clean blog UI, pull in content from the posts/ directory, apply Tailwind CSS + Heroicons, and present pages at runtime or build time.
File structure
• Top level:
• app/ – Next.js App Router folder with dynamic routes ([slug]), global CSS, layout and page entry points.
• components/ – Reusable UI pieces: Navbar, Footer, and Post.
• lib/posts.js – Helper module to load and parse Markdown from posts/.
• posts/ – Source Markdown files for each blog entry.
• public/ – Static assets (images, favicons, etc.).
• config files (next.config.mjs, postcss.config.mjs, eslint.config.mjs, jsconfig.json).
• Patterns:
• App-router driven pages, dynamic routing via [slug] directories.
• CSS pipeline using Tailwind CSS and PostCSS.
• Markdown-to-HTML conversion via a custom lib/posts.js helper.
README for additional insights
• Tech stack: Next.js 15, Tailwind CSS v4, Heroicons, custom fonts.
• Features: Responsive design (desktop, tablet, mobile), fast performance, social integration.
• Build & run instructions, how to add posts and update social links.