JokeGenerator is a Swift-based Xcode project that demonstrates the usage of the JokeAPI by utilizing a local Jokes package. The Jokes package is dependent on the RequestMaker package to handle API requests. The user interface is provided by the JokesView package, offering a seamless experience for displaying jokes fetched from the JokeAPI.
- Fetches jokes from the JokeAPI using the local Jokes package.
- Utilizes the RequestMaker package to handle API requests.
- Displays jokes in an elegant user interface provided by the JokesView package.
- Simple and easy-to-understand codebase, ideal for learning Swift app architecture.
- Xcode 15.0+
- Swift 5.9+
- iOS 17.0+
- Clone or download the JokeGenerator project repository.
- Open the project in Xcode.
- The project should automatically resolve package dependencies. If not, ensure you have an active internet connection and allow Xcode to fetch the necessary packages.
- Open the JokeGenerator project in Xcode.
- Explore the project structure, which includes the Jokes, RequestMaker, and JokesView packages, along with the main app target.
- Configure the target platform and simulator/device to run the app.
- Build and run the project in Xcode.
- The app will display a joke fetched from the JokeAPI using the Jokes package and displayed using the JokesView package.
Contributions are welcome! If you find any issues or want to enhance the project, feel free to open a pull request. Please ensure to follow the existing code style and provide clear commit messages.
- Fork the repository.
- Create a new branch for your feature or bug fix:
git checkout -b feature/your-feature-nameorbugfix/issue-number. - Commit your changes with descriptive commit messages.
- Push your branch to your forked repository.
- Open a pull request to the main repository's
mainbranch.
This project is licensed under the MIT License - see the LICENSE file for details.