Welcome to MIJUG .NET Workspace

A modern development environment that combines TypeScript application development with Jekyll documentation in a seamless, performance-optimized workspace designed for WSL integration.

Architecture Overview

Technology Foundation

  • 🔧 TypeScript 5.5+ - Modern JavaScript with strict typing and ES2022 features
  • 📖 Jekyll 4.4.1 - Static site generation with Ruby 3.3.8+YJIT performance boost
  • 🧪 Testing Suite - Jest unit testing + Playwright E2E + axe-core accessibility
  • 🏗️ Build System - Parallel TypeScript/Jekyll builds with intelligent caching
  • 🌐 WSL Integration - Optimized for Ubuntu 24.04 LTS development environment

Dual Repository Pattern

🔒 mijug-dot-net-project/    # Private development workspace
   ├── 📁 src/               # TypeScript application code
   ├── 📁 docs/              # Jekyll documentation source
   ├── 📁 tests/             # Jest unit tests
   ├── 📁 e2e/               # Playwright E2E tests
   └── 📁 scripts/           # Build and deployment automation

🌍 mijug-dot-net/           # Public deployment repository
   └── 📁 docs/             # Auto-generated Jekyll site

Workflow: Develop in private → Automated deployment → Public site

Core Capabilities

⚡ Performance-First Development

  • < 15s startup time with npm run quick:start
  • < 12s parallel builds for TypeScript + Jekyll
  • < 90s comprehensive testing across all browsers
  • Memory optimization with configurable heap limits

🛠️ Developer Experience

  • Hot reload development with instant feedback
  • VS Code integration with pre-configured workspace
  • FrontMatter CMS for visual content management
  • 70+ npm commands for every development workflow

🔍 Quality & Testing

  • WCAG 2.1 AA compliance with automated accessibility testing
  • Cross-browser compatibility (Chromium, Firefox, WebKit)
  • ESLint 9.15.0 with flat configuration and zero-warning enforcement
  • Automated CI/CD with GitHub Actions parallel job execution

📊 Enterprise Features

  • SBOM generation for supply chain security
  • Performance monitoring with build-time analysis
  • Cache management strategies for optimal development speed
  • Deployment automation with verification and rollback

Quick Start

Ready to begin? Follow this progression:

  1. 📚 Getting Started Guide - Complete setup and installation
  2. 🧪 Accessibility Testing - Configure WCAG compliance tools
  3. 📝 FrontMatter CMS - Set up visual content management

Essential Commands

Development

# Start optimized development environment
npm run dev:optimized

# Ultra-fast startup (skip initial build)
npm run quick:start

# Jekyll with drafts and live reload
npm run dev:jekyll

Testing & Quality

# Quick smoke test (< 15s)
npm run test:smoke

# Full test suite (< 90s)
npm run test:all:safe

# Pre-commit validation
npm run precheckin

Build & Deploy

# Parallel development build
npm run build:parallel

# Production deployment
npm run deploy:optimized

Architecture Benefits

🚀 Performance Optimized

  • Ruby YJIT JIT compiler provides 15-25% Jekyll build performance boost
  • Parallel build system reduces total build time by 60%
  • Memory-efficient operations with configurable limits
  • Intelligent caching reduces rebuild times by 80%

🔒 Security & Quality

  • Private development with public deployment maintains code security
  • Automated dependency vulnerability scanning
  • WCAG 2.1 AA accessibility compliance testing
  • Software Bill of Materials (SBOM) for supply chain transparency

👥 Developer Friendly

  • WSL2 native file system for optimal performance
  • VS Code workspace with pre-configured extensions
  • Comprehensive error handling and debugging support
  • Extensive documentation with troubleshooting guides

🌐 Production Ready

  • GitHub Actions CI/CD with parallel job execution
  • Automated testing across multiple browsers and devices
  • Performance monitoring and optimization tools
  • SEO-optimized Jekyll output with cache busting

What Makes This Special

Unlike typical development setups, this workspace provides:

  • 🔄 Unified Development: TypeScript and Jekyll development in a single, optimized environment
  • ⚡ Speed Focus: Every tool and process optimized for maximum developer velocity
  • 🎯 Quality Gates: Automated testing, linting, and accessibility validation
  • 📈 Scalable Architecture: Handles everything from simple sites to complex applications
  • 🛡️ Enterprise Security: Private development with automated public deployment

Next Steps

Explore the workspace capabilities:

New Users

  1. Getting Started - Installation and first steps
  2. Browser Testing - Cross-browser automation
  3. Performance Optimization - Advanced optimization

Content Creators

  1. FrontMatter CMS - Visual content management
  2. Liquid Tags - Advanced Jekyll templating
  3. Tags & Categories - Content organization

Developers

  1. Accessibility Testing - WCAG compliance setup
  2. Mermaid Diagrams - Technical documentation
  3. Cache Management - Performance strategies

🎯 Ready to dive in? Start with the Getting Started Guide for complete setup instructions.

💬 Need help? Contact our team for personalized assistance.