Carrdz - v0.5 MVP

Carrdz is a mobile-friendly web application for car enthusiasts, inspired by the classic "Top Trumps" card games. This version (v0.5) features a premium "Gamified Luxury" aesthetic based on the Jaguar Land Rover Top Trumps app, with sharp monochrome design elements and cinematic interactions.

Features

• Classic Game Mechanics: Play the 1968 Racers edition with Super Trump rules.
• Luxury Aesthetic: High-contrast monochrome UI with zero-radius (sharp) edges.
• Cinematic Experience: Full-screen car backdrops and smooth transitions.
• Global Settings Hub:
  • Theme: Toggle between Dark (Luxury) and Light (Classic).
  • Metric/Imperial: Seamlessly toggle between km/h and mph with dynamic real-time conversion.
  • Language: Toggle between English and German labels (with automatic stat value translation).
• Inline Leaderboard: Track top driver performance directly within the settings hub.
• Mobile Responsive: Optimized for high-end mobile browsers and desktop play.

Tech Stack

• Frontend: Vanilla HTML5, CSS3, JavaScript (ES6+).
• Backend: Native PHP 8.x for API and routing.
• Database: JSON-based file storage (local api/db.json).
• Server: Compatible with Shared Hosting (Hostinger), VPS, or local PHP development servers.

Installation & Setup

Local Development

1. Clone the repository:

   git clone https://github.com/techstruction/Carrdz.git

2. Navigate to the directory:

   cd Carrdz

3. Start a PHP development server:

   php -S localhost:8080

4. Open your browser to http://localhost:8080.

Deployment (Hostinger/Shared Hosting)

1. Upload: Use FTP/SFTP or Git to upload the contents of the root folder to your public_html (or equivalent) directory.
2. Permissions: Ensure the api/ directory is writable by the server so db.json can be created and updated.
3. Database: The application will automatically generate a default api/db.json on the first visit if it doesn't exist.
   • Default Admin: admin@test.com / password
   • Default Player: player1@test.com / password

Project Status

Current Version: 0.5 (Alpha / MVP)

• UI Redesign (Jaguar Aesthetic)
• Settings & Toggles (Units, Language, Theme)
• Navigation Improvements (Universal Home Buttons)
• Phase 2: Card Garage / Collection View
• Phase 2: Advanced User Management