https://github.com/benallfree/goodvibes
Modern vibecoding Three.js Starter Kit with Cloudflare Deployment
https://github.com/benallfree/goodvibes
cloudflare cloudflare-durable-objects cloudflare-pages cloudflare-workers starter starter-kit threejs typescript vibe-coding vite
Last synced: 25 days ago
JSON representation
Modern vibecoding Three.js Starter Kit with Cloudflare Deployment
- Host: GitHub
- URL: https://github.com/benallfree/goodvibes
- Owner: benallfree
- Created: 2025-04-08T21:23:25.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-14T05:39:44.000Z (26 days ago)
- Last Synced: 2025-04-15T02:47:15.765Z (25 days ago)
- Topics: cloudflare, cloudflare-durable-objects, cloudflare-pages, cloudflare-workers, starter, starter-kit, threejs, typescript, vibe-coding, vite
- Language: TypeScript
- Homepage: https://goodvibes.benallfree.com
- Size: 2.25 MB
- Stars: 32
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# 🏝️ GoodVibes
Vibescale Three.js Game Starter Kit for Building Multiplayer Web Games
https://github.com/user-attachments/assets/5bf9fdb7-186a-45ea-84f2-ea92c0aa0659
📺 [Installation Walkthrough](https://x.com/benallfree/status/1909934375359381513)
## Features
- 🎮 Build Multiplayer Web Games Fast
- 🌐 Real-time WebSocket Networking
- 🚀 Cloudflare Edge Deployment
- ⚡ Vite + TypeScript + Three.js
- 🔌 Durable Objects for Game State
- 📚 Comprehensive Documentation
## Getting Started
### Development
```bash
# Install dependencies
bun i
# Start client development server
bun run --cwd client dev
# Start server development
bun run --cwd server dev
```
### Deployment
```bash
# Build the project
bun run build
# Deploy to Cloudflare
bun run deploy
```
## Testing
### MMO Testing Made Easy
Test your multiplayer game interactions easily using [VibeCheck](https://vibecheck.benallfree.com) - a powerful testing tool that allows you to run multiple game clients simultaneously in iframes within a single browser window. This makes it simple to observe and debug real-time interactions between different players in your MMO game.
## Project Structure
```
goodvibes/
├── client/ # Frontend application
├── server/ # Cloudflare Workers + Durable Objects
└── shared/ # Shared types and utilities
```
## Tech Stack
- **Frontend**: Three.js, TypeScript, Vite
- **Backend**: Cloudflare Workers, Durable Objects
- **Package Manager**: Bun
- **Deployment**: Cloudflare Pages
## Documentation
The project includes comprehensive RAG (Retrieval-Augmented Generation) rules for maintaining and extending the codebase. These rules provide guidance for implementing features and following best practices.