Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shrijit007/ios-war-card-game
War Card Game
https://github.com/shrijit007/ios-war-card-game
figma ios-app swift swiftui
Last synced: 11 days ago
JSON representation
War Card Game
- Host: GitHub
- URL: https://github.com/shrijit007/ios-war-card-game
- Owner: Shrijit007
- Created: 2024-12-04T16:45:50.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-01-29T12:10:13.000Z (15 days ago)
- Last Synced: 2025-01-29T13:23:01.270Z (15 days ago)
- Topics: figma, ios-app, swift, swiftui
- Language: Swift
- Homepage:
- Size: 7.92 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# War Card Game - iOS App
Welcome to the **War Card Game**, an iOS application developed using **Swift** and **SwiftUI**. This app replicates the classic card game "War," where two players compete by comparing card values. The project includes all necessary resources, including code, assets, and design files, contained within this repository.
---
## Screenshots
---
## Features
- **Classic Gameplay**: Simulates the traditional War card game.
- **Smooth Animations**: Enhanced user experience with SwiftUI animations.
- **Rich Visuals**: Includes card assets and a visually appealing UI.
- **Local Play**: Play against the computer in single-player mode.
---
## Prerequisites
Ensure you have the following installed:
- **macOS**: Version 12.0 or later.
- **Xcode**: Version 13.0 or later.
- **Swift**: Version 5.5 or later.
---
## Installation
1. Clone this repository:
```bash
git clone https://github.com/your-repo/war-card-game.git
cd war-card-game
```
2. Open the project in Xcode:
```bash
open WarCardGame.xcodeproj
```
3. Build and run the app on the iOS simulator or a physical device.
---
## How to Play
1. Launch the app on your iOS device or simulator.
2. Tap "Start" to begin the game.
3. Cards will be dealt randomly to two players.
4. Each round, the top card from each player's deck is compared:
- The player with the higher card wins the round and collects both cards.
- In the event of a tie, "War" occurs, and additional cards are played.
5. The game ends when one player collects all cards.
---
## Resources
- **Cards**: High-quality card images for all 52 cards in the standard deck.
- **Sounds**: Optional sound effects for card dealing and winning rounds.
- **App Icons**: Provided in all required resolutions for iOS.
---
## Contribution
We welcome contributions to improve the game! To contribute:
1. Fork the repository.
2. Create a feature branch:
```bash
git checkout -b feature-name
```
3. Commit your changes and push to your fork.
4. Open a pull request.
---
## License
This project is licensed under the [MIT License](LICENSE).
---
Enjoy the game! 🎮 If you encounter any issues or have suggestions, feel free to open an issue. 😊