# Cards - A Flutter Card Game Collection

A collection of classic card games built with Flutter, featuring Golf Solitaire, Klondike Solitaire, and Free Cell with progressive difficulty levels, achievements, and customization options.

## Features

| Feature                           | Description                                                                                                     | Preview                                                 |
|-----------------------------------|-----------------------------------------------------------------------------------------------------------------|---------------------------------------------------------|
| **Three Classic Card Games**      | • Golf Solitaire<br>• Klondike Solitaire (Solitaire)<br>• Free Cell                                             | ![Games Preview](screenshots/games.gif)                 |
| **Progressive Difficulty System** | • Classic (Traditional ruleset)<br>• Royal (Moderate difficulty)<br>• Ace (Challenging)                         | ![Difficulty Preview](screenshots/difficulties.gif)     |
| **Interactive Tutorials**         | • Learn game mechanics with highlighted board elements<br>• Step-by-step guidance for each game                 | ![Tutorial Preview](screenshots/tutorial.gif)           |
| **Achievement System**            | • Unlock new card back designs by completing challenges<br>• Track fastest completion times for each difficulty | ![Achievements Preview](screenshots/achievements.gif)   |
| **Customization Options**         | • Custom card backs<br>• Background themes                                                                      | ![Customization Preview](screenshots/customization.gif) |
| **Cross-Platform Support**        | • Responsive design for phones, tablets, and desktops                                                           | ![Responsive Preview](screenshots/responsiveness.gif)   |

## Live Demo

Visit [cards.jlogical.com](https://cards.jlogical.com) to play the web version.

## Built With

- [Flutter](https://flutter.dev/)
- [card_game](https://pub.dev/packages/card_game) - A custom package for building card-based games
- Built by [JLogical](https://www.jlogical.com)

## Architecture

This project uses the [card_game](https://pub.dev/packages/card_game) package to handle:
- Card positioning and layouts
- Drag and drop mechanics
- Card flipping animations
- Game state management

## Contributing

While this is primarily a showcase project, contributions are welcome!

## Support

If you enjoy this project, please consider:
- Starring this repository
- Checking out the [card_game](https://pub.dev/packages/card_game) package
- Providing feedback or suggestions

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.