README.md

DiceRoller

A SwiftUI dice-rolling app that lets you roll 1 to 5 dice simultaneously with animated SF Symbol die faces.

About

DiceRoller is an interactive iOS app where users can dynamically add or remove dice (up to 5) and roll them all at once. Each die displays a random face using SF Symbols with smooth animations.

Features

• Roll 1 to 5 dice simultaneously
• Add and remove dice dynamically (min 1, max 5)
• Animated roll transitions using withAnimation
• SF Symbol die faces (die.face.1.fill through die.face.6.fill)
• Custom dark background color theme

Tech Stack

• Language: Swift
• Framework: SwiftUI
• Platform: iOS / iPadOS
• Testing: Swift Testing + XCTest
• IDE: Xcode

Project Structure

DiceRoller/
├── DiceRollerApp.swift   # App entry point
├── ContentView.swift     # Main UI with dice controls
├── DiceView.swift        # Individual die component
└── Assets.xcassets/
    └── AppBackground.colorset/

Getting Started

1. Clone the repository
2. Open DiceRoller.xcodeproj in Xcode
3. Build and run on a simulator or device

Tags

swift swiftui ios dice animation sf-symbols learning-project