Web Engine

A static site generator for modern websites, built with Next.js, MDX, and a flexible theme system.

Quick Start

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Build for production
pnpm build

Features

• MDX Content Processing - Write content in MDX with full React component support
• Theme System - Modular, swappable themes with Tailwind CSS
• External Content - Clone and process content from external repositories
• Static Generation - Full static site generation with Next.js
• TypeScript - Full TypeScript support throughout

Architecture Overview

The web engine follows a modular architecture with clear separation of concerns:

graph TB
    subgraph "External"
        CR[Content Repository]
        SC[Site Config JSON]
    end
    
    subgraph "Build Process"
        CS[Clone Script] --> CP[Copy Content]
        CP --> PC[Process Config]
        PC --> NB[Next.js Build]
    end
    
    subgraph "App Layer"
        MDX[MDX Processing]
        RT[Dynamic Routing]
        SL[Site Config Loader]
    end
    
    subgraph "Theme System"
        TC[Theme Components]
        TL[Template Logic]
        TS[Tailwind Styles]
    end
    
    subgraph "Output"
        SS[Static Site]
    end
    
    CR --> CS
    SC --> PC
    NB --> MDX
    MDX --> RT
    SL --> RT
    RT --> TC
    TC --> TL
    TL --> TS
    TS --> SS
    
    classDef external fill:#e1f5fe
    classDef build fill:#f3e5f5
    classDef app fill:#e8f5e8
    classDef theme fill:#fff3e0
    classDef output fill:#fce4ec
    
    class CR,SC external
    class CS,CP,PC,NB build
    class MDX,RT,SL app
    class TC,TL,TS theme
    class SS output

Loading

Key Components:

• Content Repository: External MDX files and configuration
• Build Scripts: Automated content processing and Next.js compilation
• App Layer: Core Next.js application with MDX processing and dynamic routing
• Theme System: Modular React components with Tailwind styling
• Static Output: Generated static site ready for deployment

Project Structure

├── app/           # Next.js application
├── themes/        # Theme packages
└── memory-bank/   # Development logs

Development

The development workflow automatically handles content processing:

• pnpm dev - Development server with content processing
• pnpm themes:dev - Theme development mode
• pnpm lint - Code linting
• pnpm format - Code formatting

Building

The build process includes content cloning, configuration processing, and static generation:

1. Clone external content repository
2. Process site configuration
3. Build Next.js application
4. Generate static output

Built for Dwarves Foundation and other modern websites.