B9 Labs

A sophisticated, high-performance platform for cataloging and showcasing engineering projects. Built with a focus on minimalism, kinetic typography, and real-time data visualization.

🚀 Quick Start

This project is a modern React application built with Next.js App Router and TypeScript.

Prerequisites

• Node.js (version 18 or higher)
• npm

Local Development

1. Clone the repository:

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

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

   This launches Next.js with hot reloading (typically on http://localhost:3000).

4. Open the browser: Navigate to the provided local URL (e.g., http://localhost:3000).

🛠 Tech Stack

• Next.js App Router: Server-first React framework with file-based routing.
• React 19: Modern UI library using the latest features.
• Tailwind CSS: Utility-first styling for high-performance design.
• Framer Motion: Advanced kinetic animations and reveal effects.
• Lucide React: Clean, consistent iconography.
• TypeScript: Type-safe engineering.

📁 Folder Structure

• /components: Reusable UI modules (Header, Hero, Counter).
• /pages: Main view layouts (Home, Projects, Archive).
• /docs: Detailed architectural and design documentation.
• types.ts: Global TypeScript definitions.
• constants.ts: Central source of truth for project data and navigation.

🧪 Documentation

For a deep dive into how B9 Labs is built, check out the docs/ directory:

• Installation & Dependencies
• Architecture
• Design System