🎲 DM Dashboard - Complete D&D 5e Tool Ecosystem

🏛️ Vision

A comprehensive suite of interconnected D&D 5e tools designed to streamline Dungeon Master workflows with unified theming, shared components, and seamless navigation between tools.

🛠️ Tools Suite

⚔️ Production Tools

• 💰 LootFactory - Advanced D&D 5e treasure generation
  • 534+ magic items from 6 official source books
  • DMG 2024 methodology with pricing calculator
  • Individual & hoard treasure generation
  • Full-stack React + Node.js application

🚧 Tools In Development

• 🏷️ Name Generator - NPC and location name generation
• 🗺️ Map Scraper - Map extraction and processing tools
• 🎯 Foundry Modding - FoundryVTT module development tools

🎨 Unified Design System

DM's Guild Color Palette

• Background: #828282 (Medium Gray)
• Headers: #FAE7C0 (Light Cream)
• Text: #000000 (Black)
• Accents: #B0212B (Dark Red)
• Secondary: #8B4513 (Brown)

Shared Components

• DM Dashboard Sidebar - Extensible navigation across all tools
• D&D Theming - Consistent fantasy fonts and styling
• Toast Notifications - Auto-expiring user feedback system
• Professional UI - Clean, readable interface design

🚀 Quick Start

LootFactory (Ready to Use)

# Backend
cd DMDashboard/LootFactory/web-app/backend
npm install
npm run dev  # Runs on localhost:3001

# Frontend  
cd DMDashboard/LootFactory/web-app/frontend
npm install
npm run dev  # Runs on localhost:5173

Development Setup

# Clone the repository
git clone https://github.com/xtratrestrial/DMDashboard.git
cd DMDashboard

# Each tool has its own setup instructions
# See individual tool README files for specific requirements

📊 Architecture

Directory Structure

DMDashboard/
├── LootFactory/           # Treasure generation (React + Node.js)
├── name-generator/        # Name generation tools (Python)
├── map_scraper/          # Map processing (Python)
├── foundry_modding/      # FoundryVTT tools (JavaScript)
├── shared/               # Shared components and themes
│   ├── components/       # React components (DmSidebar, etc.)
│   ├── themes/          # CSS themes and color schemes
│   └── assets/          # Shared images and resources
├── roadmap/              # Planning and project management
│   ├── ROADMAP.md        # Main development roadmap
│   ├── PROJECT_STATUS.md # Current project status
│   ├── PLAN.md           # Detailed development plan
│   └── issue_completion/ # Issue completion summaries
├── dm-dashboard/         # Campaign management hub
└── README.md            # This file

Technology Stack

• Frontend: React 18, TypeScript, Vite, CSS3
• Backend: Node.js, Express, TypeScript
• Data: JSON files, SQLite for dynamic data
• Styling: Custom CSS with D&D theming
• Tools: Python for data processing, JavaScript for web tools

🔧 Features

Cross-Tool Navigation

• Unified sidebar across all tools
• Tool switching without losing context
• Campaign integration (planned)
• Shared user preferences (planned)

Professional Quality

• Production-ready LootFactory with 534+ items
• DMG 2024 compliance for official D&D rules
• Extensible architecture for easy tool addition
• Clean, readable UI following accessibility guidelines

📈 Roadmap

📋 Detailed planning documents are available in the roadmap/ folder

Phase 1: Foundation ✅

• ✅ LootFactory fully functional
• ✅ Extensible DM Dashboard sidebar
• ✅ Unified theming system
• ✅ GitHub repository structure

Phase 2: DM Dashboard Hub ✅ (January 2025)

• ✅ Central campaign management dashboard
• ✅ Master color system (unified grey theme)
• ✅ 17 tools planned with technical specifications
• ✅ Shared component system ready

🚨 Next Session Priority

• 🔴 Fix LootFactory button integration (port 5175)
• 🔴 Implement unified sidebar in LootFactory
• 🟡 Global sidebar configuration
• 🟡 Database architecture decision

Phase 3: Expansion

• 📋 Name Generator web interface
• 📋 Map tools integration
• 📋 FoundryVTT module suite
• 📋 Unified deployment system

Phase 4: Advanced Features

• 📋 AI-powered DM assistance
• 📋 Campaign automation tools
• 📋 Multi-user collaboration
• 📋 Mobile app development

📋 Planning Documents

• Main Roadmap - Complete development phases and milestones
• Project Status - Current progress and achievements
• Development Plan - Detailed technical specifications
• Issue Completions - Completed work summaries

🤝 Contributing

1. Fork the repository
2. Create feature branch: git checkout -b feature/amazing-feature
3. Follow tool-specific guidelines in individual README files
4. Maintain unified theming and component consistency
5. Submit pull request with detailed description

📄 License

MIT License - see individual tool directories for specific licensing information.

🎯 Contact

• GitHub: xtratrestrial
• Project: DMDashboard

---

🎲 Ready to enhance your D&D campaigns with professional-grade tools! ✨