The most comprehensive digital archive and technical resource for Classic Mini enthusiasts worldwide (1959-2000). Free, open source, and designed to be permanently accessible.
Explore the website »
Report Bug
·
Request Feature
·
Support Server Costs
Table of Contents
Classic Mini DIY is a comprehensive web application serving as both a toolkit and permanent archive for Classic Mini enthusiasts. The project combines technical calculators, historical documentation, user profiles, a community contribution system, and AI-powered assistance to create the most complete digital resource for Classic Mini owners worldwide.
The platform is designed to be both a real-time working tool for mechanics and enthusiasts, and a permanent digital archive ensuring Classic Mini knowledge is preserved for future generations. All content is backed up across multiple cloud locations and designed to remain accessible indefinitely.
Core Technologies:
- Nuxt 4.1.2 - Vue.js framework with server-side rendering
- Vue 3 - Composition API with
<script setup>syntax - TypeScript - Strict type checking throughout
- TailwindCSS 4.1.13 - Utility-first CSS with @tailwindcss/vite
- Nuxt UI - Component library for forms, modals, accordions, and more
- Font Awesome 6 - Icon library (loaded via CDN kit)
- Supabase - Authentication, database, and file storage
- AWS Services - S3 storage, DynamoDB (legacy data)
- LangGraph SDK - AI-powered conversational assistance
- Highcharts - Interactive data visualization
- Fuse.js - Advanced fuzzy search
- PostHog - Product analytics and event tracking
- Mapbox - Location autocomplete for user profiles
Infrastructure:
- Cloudflare Workers - Production hosting (Vercel retired)
- Supabase - PostgreSQL database, Auth, Edge Functions, Storage
- AWS S3 - Intelligent tiering storage with versioning for archive assets
- PostHog - Analytics (replaced Google Analytics and Vercel Analytics)
- Bun - Package manager and script runner
- User Dashboard - Centralized hub for submissions, account settings, and activity
- Profile System - Avatar uploads, social links, location, privacy controls shared across the CMDIY ecosystem
- 8 Interactive Technical Calculators - Compression ratio, gearbox, SU carburetors, and more
- Comprehensive Digital Archive - Workshop manuals, wiring diagrams, historical documents (powered by Supabase)
- Community Contributions - Submit wheels, colors, registry entries, and documents with suggest-edit modals on every detail page
- AI-Powered Assistant - LangGraph-based conversational AI
- 10-Language Support - Full internationalization with browser detection
- Progressive Web App - Offline functionality and mobile-optimized experience
- Admin Moderation - Unified queue for reviewing all submission types with user management
- ECU Maps Store - Multi-platform tuning maps with GitHub integration
- Advanced Search - Fuse.js powered fuzzy search across all content
Classic Mini DIY is part of a broader ecosystem of applications sharing a single Supabase backend:
| Property | Description | URL |
|---|---|---|
| Classic Mini DIY (this repo) | Knowledgebase, archive, community site, and the marketplace at /exchange |
classicminidiy.com |
| Classic Mini Toolbox | iOS and Android mobile apps | App Store / Google Play |
The Mini Exchange is retired as a standalone property. The marketplace was consolidated into this repo and went live at classicminidiy.com/exchange on 2026-07-13.
theminiexchange.comnow 301s here.
All properties share authentication via Supabase with custom domain auth.classicminidiy.com. Users sign in once and their profile, avatar, and preferences carry across all platforms. Sustaining Members ($1.99/mo via the App Store, Google Play, or classicminidiy.com) unlock a unified set of benefits across all properties.
- Node.js v24 or higher
- Bun (package manager) - install instructions
- Git for version control
-
Clone the repository
git clone https://github.com/ClassicMiniDIY/classicminidiy.git cd classicminidiy -
Install dependencies
bun install
-
Start development server
bun run dev
-
Open your browser Navigate to
http://localhost:3000to see the application
Create a .env file in the root directory with the following variables:
# Supabase
SUPABASE_URL=your_supabase_project_url
SUPABASE_KEY=your_supabase_anon_key
# AWS Credentials (for legacy data and S3 storage)
dynamo_id=your_dynamodb_access_key
dynamo_key=your_dynamodb_secret_key
s3_id=your_s3_access_key
s3_key=your_s3_secret_key
# External APIs
GITHUB_API_KEY=your_github_api_key
YOUTUBE_API_KEY=your_youtube_api_key
# AI Services
NUXT_LANGGRAPH_API_URL=your_langgraph_api_url
NUXT_LANGSMITH_API_KEY=your_langsmith_api_key
# Analytics
POSTHOG_PUBLIC_KEY=your_posthog_key
POSTHOG_HOST=https://us.i.posthog.com
# Mapbox (profile location autocomplete)
NUXT_PUBLIC_MAPBOX_TOKEN=your_mapbox_token
# Public URLs
NUXT_PUBLIC_SITE_URL=https://classicminidiy.com
s3Base=https://classicminidiy.s3.us-east-1.amazonaws.combun run dev # Start development server
bun run build # Build for production
bun run start # Preview production build
bun run format # Format with Prettier — WHOLE REPO, see the note below
bun run test # Run unit tests with VitestThe technical toolbox provides interactive calculators and reference tools essential for Classic Mini maintenance and modification:
-
Compression Ratio Calculator (
/technical/compression)- Engine compression calculations with piston, crankshaft, head gasket configurations
- Real-time calculations with visual feedback
- Support for custom measurements and part specifications
-
Gearbox Calculator (
/technical/gearing)- Gear ratio calculations and speed computations
- Multiple gearbox configurations
- RPM and speed analysis tools
-
SU Carb Needle Configurator (
/technical/needles)- Interactive needle comparison with Highcharts visualization
- Comprehensive needle database
- Performance curve analysis
-
Chassis Number Decoder (
/technical/chassis-decoder)- Historical chassis number database and identification
- Year and model identification
- Production date estimation
-
Engine Number Decoder (
/technical/engine-decoder)- Engine code interpretation and specifications
- Performance data and compatibility information
- Common Clearances Reference (
/technical/clearance) - Comprehensive clearance specifications by system - Parts Equivalency Database (
/technical/parts) - Cross-reference part numbers between brands - Torque Specifications Chart (
/technical/torque) - Complete torque specification database
The archive system preserves and organizes historical Classic Mini documentation. In v8.0.0, the entire archive was migrated from DynamoDB/S3/@nuxt/content to Supabase with unified document pages, collection support, filters, search, and sort.
- Workshop Manuals (
/archive/manuals) - Complete digitized workshop manuals with full-text search - Electrical Wiring Diagrams (
/archive/electrical) - Positive and negative ground systems by year and model - Historical Advertisements (
/archive/adverts) - Period advertising materials and brochures - Vendor Catalogues (
/archive/catalogues) - Historical parts catalogs and documentation - Tuning & Modifications (
/archive/tuning) - Performance modification guides and specifications
- Document Browser (
/archive/documents) - Unified listing of all archive documents with filters, search, and sort - Collection Pages (
/archive/documents/collection/[slug]) - Grouped document collections - Document Detail Pages (
/archive/documents/[slug]) - Rich metadata, download links, and suggest-edit capability - 301 Redirects - All legacy document URLs redirect to new unified paths
- Registry System (
/archive/registry) - User-submitted Classic Mini registrations with admin approval - Wheel Fitment Library (
/archive/wheels) - Comprehensive wheel database with user photos - Color Database (
/archive/colors) - Historical paint colors with hex values and user contributions - Engine Specifications (
/archive/engines) - Complete engine database with performance specs - Vehicle Weights Reference (
/archive/weights) - Weight specifications by model and year
New in v8.0.0 — a centralized user experience:
- Submissions Management - View, filter, and expand all your submissions (wheels, colors, registry, documents) with detailed status tracking
- Submission Details - Click any submission to expand and see full details inline
- Activity Summary - At-a-glance counts of total submissions and their statuses
- Quick Actions - Links to contribute, edit profile, and manage account
- Public Profile - View your public-facing profile with avatar, display name, location, and activity summary
- Profile Editing (
/profile/edit) - Full profile management:- Avatar upload with crop and preview
- Display name
- Mapbox-powered location autocomplete (city, state, country format)
- Bio / about section
- Social links (Instagram, Facebook, YouTube, website)
- Privacy toggles (public profile, show vehicles)
- Shared Across Ecosystem - Profile data is shared with the
/exchangemarketplace and the mobile apps via Supabase
- Contributor profile pages showing submission activity and social links
- Welcome Page (
/welcome) - First-time users are redirected here after auth callback for profile setup - Unified Account Messaging - Login page explains the shared CMDIY ecosystem account
New in v8.0.0 — a unified contribution hub replacing scattered submission pages:
- Type Selection Grid - Choose from wheel fitment, color, registry, or document contributions
- Self-Contained Forms - Each contribution type has its own page with file upload support
- Suggest-Edit Modals - Every archive detail page (documents, colors, wheels) has an inline suggest-edit button
- Contribute CTAs - Archive hub and section listing pages prominently feature contribution calls-to-action
/contribute/wheel- Wheel fitment data with photo uploads/contribute/color- Paint color submissions with hex values/contribute/registry- Classic Mini registration with photos/contribute/document- Document submissions with file uploads and collection assignment
- Conversational AI - LangGraph-powered assistant with Classic Mini expertise
- Model Context Protocol (MCP) Server - A single JSON-RPC endpoint at
/mcpexposing the calculators (compression, gearbox, chassis decoder) to AI clients - Streaming Responses - Real-time AI chat with persistent conversation threads
- Context Awareness - Understanding of Classic Mini technical specifications and archive content
Every admin page shares one shell (AdminShell) with a grouped sidebar, so
navigation is identical wherever you are.
- Dashboard (
/admin) - Triage board: what is waiting for review, and how much of it - Submission Queue (
/admin/queue) - The single queue for every submission type (documents, registry, colours, wheels, edit suggestions) with approve / reject / request-changes. The old per-type review pages (/admin/{registry,wheels,colors}/review) and/admin/inboxall read this same queue and now redirect to it - Marketplace (
/admin/exchange) - Listings, moderation, messages, finds, wanted posts, social posting, announcements, newsletter - 3D Models (
/admin/models) - Model library queue, reports, sellers, sales - User Management (
/admin/users) - User administration with trust levels - Discord Roster (
/admin/discord) - Members-only Discord reconciled against paid membership - Chat Threads (
/admin/threads) - Reviewing AI chat threads
- Multi-ECU Support - Haltech, Speeduino, MegaSquirt, and more
- GitHub Integration - Real-time repository updates and release management
- Feature Matrix - Ignition maps, fuel maps, VE tables, target AFR configurations
- Promotional Banners - HeroPromo component with auto-rotating promotional carousel
- Recent Videos - YouTube channel integration
- Community Stats - Live statistics from YouTube and GitHub
- Mobile App Promotion - Native app download CTAs
The Classic Mini DIY platform exposes 50+ REST API endpoints:
GET /api/decoders/chassis- Chassis number decoding by year rangesGET /api/decoders/engine- Engine code interpretation and identification
GET /api/wheels/- Wheel fitment database with image handlingGET /api/registry/- User registration system with approval workflowGET /api/colors/- Paint color database with user contributionsGET /api/engines/- Engine specifications and performance dataGET /api/weights/- Vehicle weight specifications
POST /api/langgraph/- AI chat integration with streaming responsesPOST /mcp- Model Context Protocol server (JSON-RPC over Streamable HTTP, Bearer auth). Seeserver/mcp/README.md
GET /api/admin/queue/- Unified submission queue (list, count, approve, reject, request-changes)PUT /api/admin/listings/:id- Correct a listing's content in place, without sending it back through moderationPUT /api/admin/listings/:id/{status,tier}- Listing moderation and premium tierGET /api/admin/users/- User management and trust levelsPOST /api/admin/auth- Authentication and session management
GET /api/github/- Repository statistics, commits, and release dataGET /api/youtube/- Channel statistics and video integrationGET /api/maps/- ECU maps store with GitHub integration
GET /api/app-config.json- Mobile app backend rollout configuration
- Supabase - Auth, database, storage, and Edge Functions
- GitHub API - Repository statistics, commits, releases
- YouTube API - Channel statistics, video feeds
- AWS Services - S3 storage, DynamoDB (legacy)
- Mapbox - Geocoding for location autocomplete
- PostHog - Product analytics
Classic Mini DIY supports 10 languages with comprehensive internationalization via @nuxtjs/i18n:
| Language | Code | Status |
|---|---|---|
| English | en |
Primary / Reference |
| German | de |
Most comprehensive |
| Spanish | es |
Complete |
| French | fr |
Complete |
| Italian | it |
Complete |
| Portuguese | pt |
Complete |
| Russian | ru |
Complete |
| Japanese | ja |
Complete |
| Chinese | zh |
Complete |
| Korean | ko |
Complete |
- Browser Detection - Automatic language detection on first visit
- Persistent Preferences - Cookie-based language memory
- Dynamic Switching - Real-time language changes via the language switcher component
- SEO Optimization - Language-specific meta tags,
hreflangattributes, and localized URLs - Component-Level i18n - Each component/page uses
<i18n>blocks for scoped translations
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
-
Fork the Repository
git clone https://github.com/ClassicMiniDIY/classicminidiy.git
-
Create a Feature Branch
git checkout -b feature/AmazingFeature
-
Make Your Changes
- Follow the existing code style and conventions
- Use Vue 3 Composition API with
<script setup>syntax - Use Nuxt UI components for UI elements
- Use Font Awesome 6 icons only (no Heroicons or Lucide)
- Add translations for new text content across all 10 locales
- Add tests for new functionality
-
Test Your Changes
bun run build bun run testFormat only the files you touched — do not run
bun run formaton a branch. It rewrites the entire repo, and because contributors resolve slightly different Prettier versions, that reformats hundreds of files you never edited and buries your actual change in the diff:bunx prettier --write path/to/the/files/you/changed
-
Commit Your Changes
git commit -m 'feat: add some amazing feature' -
Push to Your Branch
git push origin feature/AmazingFeature
-
Open a Pull Request into
main
- Focus on Classic Mini Content - Ensure contributions are relevant to Classic Mini enthusiasts
- Document Changes - Update relevant documentation and comments
- Test Thoroughly - Verify functionality across different devices and browsers
- Follow Design Patterns - Use Nuxt UI components, TailwindCSS, and existing patterns
- Consider Internationalization - Add translation keys for new text content in all 10 locales
- Accessibility - Follow WCAG 2.2 AA standards
You don't need to write code to contribute! Visit classicminidiy.com/contribute to submit:
- Wheel fitment data and photos
- Paint color information
- Classic Mini registry entries
- Workshop manuals and historical documents
The application is deployed to Cloudflare Workers by
.github/workflows/deploy-cloudflare.yml on every push to main. CI owns the deploy — a
local wrangler deploy is reverted by the next merge. Vercel is retired and vercel.json
has been removed.
To build and preview locally:
# Build the application
bun run build
# Preview the production build locally
bun run start- Node.js v24+
- Bun package manager
- Install Command:
bun install --frozen-lockfile - Build Command:
bun run build - Output Directory:
.nuxt/dist - Environment Variables: See Environment Setup
- Server-Side Rendering - Pre-rendered pages for optimal SEO and performance
- Code Splitting - Optimized bundle sizes with manual chunks
- Image Optimization - WebP and AVIF formats with responsive sizing
- PWA Caching - Service worker with intelligent caching strategies
- Edge Functions - Global distribution for API routes
- CDN - S3 static assets with intelligent tiering
- Console Stripping -
drop_console: truein production builds
- Bug Reports - GitHub Issues
- Feature Requests - GitHub Issues
- Discussions - GitHub Discussions
Help keep the servers running and the project growing:
Your support helps cover:
- Server hosting and Supabase costs
- Database and storage fees
- CDN and bandwidth costs
- Development tools and services
- Classic Mini DIY YouTube - Video tutorials and builds
- Classic Mini Toolbox - iOS and Android mobile apps
- Seven Mini Parts - SU needle charts and technical specifications
- MintyLamb - Original needle configurator inspiration
- MiniColours.co.uk - Color reference database
- miniweights.co.uk - Vehicle weight specifications (archived)
- mk1-performance.com - Historical archive content (archived)
- Classic Mini Forums - Technical knowledge and specifications
- User Submissions - Registry entries, wheel photos, color contributions, and documents
- Community Feedback - Bug reports, feature requests, and improvements
- Nuxt - Vue.js framework
- Nuxt UI - Component library
- TailwindCSS - Utility-first CSS
- Supabase - Backend-as-a-service
- Highcharts - Data visualization
- Fuse.js - Fuzzy search
- LangGraph - AI agent framework
- PostHog - Product analytics
- Font Awesome - Icon library
Distributed under the GNU General Public License v3.0.
This ensures that:
- The project remains free and open source
- Modifications must also be open source
- Commercial use is permitted
- The project can be freely distributed
See LICENSE file for more information.
Classic Mini DIY - Preserving Classic Mini knowledge for future generations
Made with love by the Classic Mini community