Gaming Portal

Copyright (C) 2025 Kusala Tech

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Contact

Kusala Tech Email: [email protected]

A modern HTML5 gaming portal built with PHP, Tailwind CSS, and PostgreSQL. This project follows modern PHP practices and includes features like game categorization, ratings, and play tracking.

Features

• 🎮 HTML5 Games Support
• 📱 Responsive Design
• 🌙 Dark Mode Support
• 🌐 Multi-language Support
• ⭐ Game Ratings System
• 📊 Play Count Tracking
• 🏷️ Game Categories
• 🔍 SEO Optimized
• ♿ WCAG 2.1 Compliant
• 📈 Analytics Integration
• 💰 AdSense Ready

Requirements

• PHP 8.4 or higher
• PostgreSQL 15 or higher
• Redis (for caching)
• Composer
• Docker and Docker Compose

Installation

1. Clone the repository:

   git clone https://github.com/yoursw/gaming-portal.git
   cd gaming-portal

2. Start the Docker containers:

   docker-compose up -d

3. Install PHP dependencies:

   docker-compose exec php-fpm composer install

4. Create the database schema:

   docker-compose exec postgres psql -U root -d app -f /application/src/config/schema.sql

5. Set up the web server:

   # The nginx configuration is already included in the docker-compose setup

Development

• The application uses Slim Framework 4 for routing and middleware
• Twig for templating
• Tailwind CSS for styling
• PostgreSQL for data storage
• Redis for caching

Directory Structure

backend/
├── public/          # Public files and entry point
├── src/
│   ├── config/     # Configuration files
│   ├── Controller/ # Controllers
│   ├── Entity/     # Domain entities
│   ├── Repository/ # Data access layer
│   └── templates/  # Twig templates
├── var/            # Cache and logs
└── vendor/         # Composer dependencies

Running Tests

docker-compose exec php-fpm composer test

Code Style

The project follows PSR-12 coding standards. To check the code style:

docker-compose exec php-fpm composer cs-check

To automatically fix code style issues:

docker-compose exec php-fpm composer cs-fix

Deployment

1. Set up your production environment variables
2. Build and push your Docker images
3. Deploy using your preferred method (e.g., Kubernetes, Docker Swarm)

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.

Acknowledgments

• Slim Framework
• Tailwind CSS
• Twig
• PostgreSQL
• Redis