{"id":23899305,"url":"https://github.com/alexisanzieu/donjon-dragon","last_synced_at":"2026-06-14T18:37:58.868Z","repository":{"id":270159654,"uuid":"882885210","full_name":"AlexisAnzieu/donjon-dragon","owner":"AlexisAnzieu","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-12T21:01:34.000Z","size":7396,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-13T18:03:26.224Z","etag":null,"topics":["dnd","dnd-kit","dnd-tools","tabletop"],"latest_commit_sha":null,"homepage":"https://dnd.h2t.club/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlexisAnzieu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-11-04T01:25:14.000Z","updated_at":"2025-11-12T21:01:38.000Z","dependencies_parsed_at":null,"dependency_job_id":"ab485cb5-5e5a-4bb8-b008-dab2743e2ac2","html_url":"https://github.com/AlexisAnzieu/donjon-dragon","commit_stats":null,"previous_names":["alexisanzieu/donjon-dragon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AlexisAnzieu/donjon-dragon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexisAnzieu%2Fdonjon-dragon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexisAnzieu%2Fdonjon-dragon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexisAnzieu%2Fdonjon-dragon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexisAnzieu%2Fdonjon-dragon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlexisAnzieu","download_url":"https://codeload.github.com/AlexisAnzieu/donjon-dragon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexisAnzieu%2Fdonjon-dragon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34333806,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dnd","dnd-kit","dnd-tools","tabletop"],"created_at":"2025-01-04T18:17:36.243Z","updated_at":"2026-06-14T18:37:58.851Z","avatar_url":"https://github.com/AlexisAnzieu.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Virtual Tabletop Application\n\nA modern web application for managing tabletop role-playing game sessions with real-time collaboration features.\n\n## Core Features\n\n- Interactive game board with WebSocket-based token management\n- Dynamic fog of war system\n- Real-time sound effects with MIDI controller support\n- RGB light control system integration\n- Character creation and management\n- Equipment and inventory system\n- Monster database with thermal printer integration\n- Session management and tracking\n\n## Tech Stack\n\n- **Frontend**: Next.js 13+, TypeScript, Tailwind CSS\n- **Backend**: Next.js API routes, PartyKit for WebSocket\n- **Database**: MySQL with Prisma ORM\n- **Authentication**: NextAuth.js\n- **APIs**: Freesound, Cloudinary\n\n## Requirements\n\n- Node.js 18+\n- MySQL 8+\n- Cloudinary account\n- Freesound API key\n- (Optional) MIDI controller\n- (Optional) Thermal printer\n\n## Project Structure\n\n```\n├── app/                # Next.js app directory\n│   ├── api/           # API routes\n│   ├── components/    # Shared components\n│   ├── game/         # Game components\n│   ├── hooks/        # Custom hooks\n│   └── services/     # External services\n├── lib/               # Utilities\n├── party/            # PartyKit server\n├── prisma/           # Database\n└── public/           # Static assets\n```\n\n## Setup\n\n1. Clone and install dependencies:\n\n2. Configure environment:\n\n```bash\ncp .env.example .env.local\n# Add your credentials to .env.local:\n# - Database URL\n# - Cloudinary credentials\n# - Freesound API key\n# - Lumia Stream token\n# - Auth secret (generate with: openssl rand -base64 32)\n```\n\n3. Initialize database:\n\n```bash\nnpx prisma generate\nnpx prisma db push\n```\n\n4. Start development servers:\n\n```bash\nnpm run dev          # Next.js\nnpm run party:dev    # PartyKit\n```\n\n## Development\n\n### Database Changes\n\n```bash\nnpx prisma migrate dev --name change_description\nnpx prisma studio    # Database UI\n```\n\n### Real-time Features\n\n- WebSocket server: `party/index.ts`\n- Client connections: `lib/websocket.tsx`\n- State management: `app/game/context/`\n\n### Component Guidelines\n\n- Use server components by default\n- Add 'use client' directive for client components\n- Follow Next.js 13+ app directory conventions\n\n## Features\n\n### Game Board\n\n- WebSocket-based token management\n- Dynamic zoom and pan\n- Customizable fog of war\n- Background image support\n- Fullscreen mode\n\n### Token System\n\n- HP tracking\n- Size customization\n- Visibility controls\n- Context menu actions\n- Status indicators\n\n### Sound System\n\n- Sound library management\n- MIDI controller support\n- Multiple sound playback\n- Volume control per effect\n- Favorites system\n\n### Additional Systems\n\n- Character creation\n- Equipment management\n- Monster database\n- Session tracking\n- User authentication\n- Light control integration\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Submit a pull request\n\n## License\n\nMIT - See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexisanzieu%2Fdonjon-dragon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexisanzieu%2Fdonjon-dragon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexisanzieu%2Fdonjon-dragon/lists"}