<div align="center">

📊 Nexus Business

The Executive Business Knowledge Base

Curated frameworks, actionable playbooks, and battle-tested strategies to build, scale, and optimize world-class companies.

</div>

🚀 Overview

Nexus Business is a premium, open-source knowledge base platform built for entrepreneurs, managers, and executives. It acts as a single centralized repository to document, explore, and compress world-class business insights across 10 core domains.

The platform is designed with a highly scalable architecture, utilizing a robust tech stack to handle everything from personal reading progress to complex knowledge graphs connecting different business concepts.

🛠️ Tech Stack

This repository follows modern, enterprise-grade engineering standards:

• Framework: Next.js 16.1.6 (App Router, React 19, Turbopack)
• Styling: Tailwind CSS v4 & Framer Motion (Premium Animations)
• UI Components: shadcn/ui & Radix UI
• Database: Neon Postgres (Serverless)
• ORM: Drizzle ORM
• Authentication: Auth.js v5 (NextAuth beta)
• Content Engine: MDX via next-mdx-remote
• Testing: Vitest & React Testing Library

📚 Information Architecture

The content is organized into 10 fundamental business domains, designed to provide a 360-degree view of company building:

1. Startup & Entrepreneurship 🚀
2. Strategy & Management 🎯
3. Marketing & Growth 📈
4. Finance & Investment 💰
5. Operations & Execution ⚙️
6. Product Management 🎯
7. Sales & Business Development 🤝
8. Digital Business & Tech 💻
9. Leadership & People 👥
10. Indonesian Business Context 🇮🇩

Each domain contains various structured Content Types (e.g., Frameworks, Playbooks, Case Studies, Mental Models, Metrics).

⚡ Getting Started

1. Prerequisites

Ensure you have Node.js 20+ installed.

2. Install Dependencies

npm install

3. Environment Setup

Copy the example environment variables and fill them in:

cp .env.example .env.local

You will need:

• A Neon Postgres Database URL (DATABASE_URL and DIRECT_URL)
• A GitHub OAuth App for Authentication (AUTH_GITHUB_ID and AUTH_GITHUB_SECRET)
• An arbitrary AUTH_SECRET string (generate via npx auth secret)

4. Database Setup

Push the Drizzle Schema to your Neon database:

npm run db:push
# or run migrations: 
npm run db:generate
npm run db:migrate

5. Run the Development Server

npm run dev

The app will be running smoothly on http://localhost:3000.

🧪 Testing

The repository is fully configured with Vitest.

# Run all tests
npm run test

# Run tests in watch mode
npm run test -- --watch

🔄 CI/CD

We use GitHub Actions to guarantee code quality. The pipeline automatically runs:

1. Type checking (tsc)
2. Linting (eslint)
3. Unit Tests (vitest)
4. Production Build Verification (next build)

On every pull request to or push against the main branch.

📄 License

This knowledge base system is licensed under the MIT License.