🏟️ GameGround — Futsal Ground Discovery & City Selection Platform

GameGround is a modern web application built to help users quickly discover futsal grounds in their city.
It features a fast, reactive interface powered by Laravel, Inertia.js, and React/TypeScript, delivering a smooth browsing experience with intelligent city selection and filtering capabilities.

The project focuses on speed, simplicity, and providing a seamless user journey when exploring futsal venues.

---

✨ Key Features

🏙️ Smart City Selection

• Dynamic city search
• Debounced user input for performance
• Local caching with TTL expiration
• Auto-restores previously selected city

🏟️ Futsal Ground Discovery

• Browse grounds based on the selected city
• Dynamic UI powered by Inertia.js
• Smooth navigation and minimal reloads

⚡ Modern Full-Stack Architecture

• Laravel backend
• React + TypeScript frontend
• Vite-powered development environment

---

⚙️ Installation & Setup

You can run the project using Laravel Sail (Docker) or your local PHP setup.

---

🚀 Option 1: Install & Run Using Laravel Sail (Recommended)

1. Install dependencies

composer install
npm install

2. Create your environment file

cp .env.example .env

3. Start Sail

./vendor/bin/sail up -d

4. Generate application key

./vendor/bin/sail artisan key:generate

5. Run database migrations

./vendor/bin/sail artisan migrate

6. Build frontend assets

./vendor/bin/sail npm run dev

7. Access the application

http://localhost

---

🚀 Option 2: Install & Run Without Sail (Local Development)

Requirements

• PHP 8.x
• Composer
• MySQL / MariaDB
• Node.js (LTS)
• Optional: Laravel Valet / XAMPP / WAMP

---

1. Install backend dependencies

composer install

2. Install frontend dependencies

npm install

3. Setup environment

cp .env.example .env

Update .env with your database settings.

4. Generate application key

php artisan key:generate

5. Run migrations

php artisan migrate

6. Build assets

npm run dev

7. Start the local server

php artisan serve

Visit:
http://localhost:8000

---

🧹 Troubleshooting

Node / Vite issues

npm install --force

Permission errors (Linux)

chmod -R 775 storage bootstrap/cache