Home

Welcome to the TTT (Tic-Tac-Toe) Wiki

A modern, web-based multiplayer Tic-Tac-Toe game with emoji pieces, real-time Firebase synchronization, and visual gradient effects.

Quick Links

• Play Live Demo
• Source Code
• Report an Issue

Available Versions

Version	Branch	Stability	Description
Production	Main	✅ Stable	Fully tested, production-ready release (v2.0.0)
Beta	Beta	🟡 Testing	Feature-complete, undergoing final testing
Alpha	Alpha	🟠 Development	New features, may have bugs
Experimental	Experimental	🔴 Unstable	Cutting-edge features, experimental code

All versions are hosted via GitHub Pages at the same URL with branch-specific paths.

What's New

Check out the latest features and improvements in each version:

• Main Branch - Latest stable release (v2.0.0 - November 12, 2025)
• Beta Branch - Upcoming features
• Alpha Branch - In-development features
• Experimental Branch - Experimental features

Getting Started

New to TTT? Start here:

1. How to Play - Learn the basics of multiplayer gameplay
2. Installation Guide - Set up your own instance
3. Contributing Guidelines - Help improve the project
4. Firebase Setup - Configure multiplayer functionality

Current Features (v2.0.0)

• 🎯 Classic Tic Tac Toe Gameplay - The timeless 3×3 grid game
• 👥 Real-Time Multiplayer - Firebase-powered live synchronization
• 🎨 Custom Emoji Pieces - Choose from 20+ emojis (❌ ⭕ ❤️ 💲 😀 💀 🤖 👽 🐶 😺 💩 🦐 🍕 🍣 🍓 🍤 🌙 ☀️ ⭐ 🚀)
• ✨ Duplicate Emoji Support - Both players can select the same emoji
• 🌈 Visual Gradient Effects - Blue glow for your moves, red glow for opponent's
• 🏠 Room Codes - Share 4-character codes to join games
• 📱 Mobile Responsive - Seamless play on all devices
• 🔄 Role-Based Architecture - Reliable Host/Guest player tracking

Project Structure

ttt/
├── index.html              # Main menu/lobby
├── game.html               # Game board interface
├── style.css               # Game board styling (with gradient effects)
├── home.css                # Menu styling
├── multiplayer.js          # Room creation & joining logic
├── game-multiplayer.js     # Game logic & Firebase sync
├── utils.js                # Utility functions
├── svg-icons.html          # SVG icon definitions
├── README.md               # Project documentation
├── CONTRIBUTING.md         # Contribution guidelines
└── LICENSE                 # GPL-3.0 License

Technologies

• HTML5 - Semantic markup
• CSS3 - Modern styling with Flexbox, Grid, animations, gradients
• Vanilla JavaScript (ES6+) - No frameworks, pure ES6 modules
• Firebase Realtime Database - Real-time multiplayer sync
• GitHub Pages - Multi-branch hosting via gh-pages

Resources

• API Reference - Firebase integration and game logic
• Troubleshooting - Common issues and solutions
• Roadmap - Upcoming features and improvements
• Changelog - Version history and updates
• Label Guidelines - GitHub issue labeling system

Contributing

Contributions are welcome! Please read the Contributing Guidelines before submitting PRs.

Quick Contribution Steps

1. Fork the repository
2. Create a feature branch (feature/amazing-feature)
3. Follow existing code style and conventions
4. Test on multiple browsers and mobile devices
5. Submit a PR to the main branch

Reporting Issues

Use proper labels when creating issues:

• priority: high/medium/low - Issue urgency
• enhancement - New features
• bug - Something broken
• documentation - Docs improvements
• good first issue - Beginner-friendly tasks

Support

• GitHub Issues: Report bugs or request features
• Discussions: Share ideas and get help
• License: GPL-3.0

---

Built with ❤️ by Steven Farless | Version 2.0.0 | November 12, 2025

🌟 Star this repo if you enjoy the game! 🌟

Wiki Navigation Tips

To navigate this wiki:

• Use the Pages sidebar on the right to browse all wiki pages
• Click any [[Page Name]] link to navigate to that page
• Use your browser's back button to return to previous pages
• Search functionality is available in the top-right corner

---

Setting Up This Wiki

To create additional wiki pages:

1. Click the Wiki tab in your repository
2. Click New Page in the upper-right corner
3. Add content using Markdown syntax
4. Save with a descriptive commit message

Pro tip: Create internal links using double brackets: [[Page Name]]