🦆 Gander Site - Technical Documentation Site

A VitePress-based documentation site featuring technical articles, code solutions, and development guides. Built with modern web technologies and deployed as a static site.

🚀 Quick Start

Prerequisites

• Bun (v1.0+ recommended)
• Alternative: Node.js (v18+ recommended) with npm or yarn

Installation

bun install

Development

# Start development server with environment variables
bun run dev

Build & Deploy

# Build for production
bun run build

# Preview production build
bun run preview

📁 Project Structure

docs/
├── index.md                 # Homepage
├── solutions/               # Organized solutions
│   ├── pimcore/            # Pimcore CMS solutions
│   ├── self-hosted/        # Self-hosting guides
│   └── services/           # External service integrations
├── tools/                   # Development tools & utilities
├── utils/                   # General utilities
├── assets/                  # Images and static assets
└── public/                  # Public assets (favicons, manifests)

.vitepress/
├── config.ts                # Main VitePress configuration
└── functions/
    └── _middleware.js       # Cloudflare Functions middleware

🛠️ Technology Stack

• Static Site Generator: VitePress
• Environment Management: dotenvx
• Deployment: Cloudflare Pages
• Analytics: Umami & Medama integration
• Security: Content Security Policy with nonce-based loading
• Language: TypeScript configuration

📚 Content Categories

🔧 Services

External service integrations and API documentation

🏠 Self-Hosted

Self-hosting solutions and server configurations

📦 Pimcore

CMS-specific solutions, workflows, and integrations

🛠️ Tools/Projects

Development tools, utilities, and project guides

⚙️ Utils

General utility documentation and helpers

📜 Outdated

Legacy content maintained for reference

🔒 Security Features

• Content Security Policy: Strict CSP with nonce-based script/style loading
• Security Headers: Comprehensive security header implementation
• CSP Reporting: External endpoint for CSP violation reporting
• Environment-based: All external integrations are environment-variable driven

🌟 Key Features

• ✅ Clean, searchable documentation interface
• ✅ Hierarchical navigation structure
• ✅ Deep outline navigation for better accessibility
• ✅ Mobile-responsive design
• ✅ Analytics integration (Umami, Medama)
• ✅ SEO optimized
• ✅ Security-first approach with CSP
• ✅ Environment-based configuration

📝 Available Commands

Command	Description
bun run dev	Start VitePress dev server with environment variables
bun run build	Build the static site for production
bun run preview	Serve the built site locally for testing
bun run dotenvx	Access dotenvx commands for environment management

🤝 Contributing

This is a personal documentation site. Content is organized to be easily searchable and navigable for technical reference.

📄 License

All content and code in this repository is for personal use and documentation purposes.