Welcome to the Event Registration App! This is a Kotlin Multiplatform (KMP) project that allows users to view a list of events and register for their preferred events. This project serves as a training ground for Kotlin Multiplatform development.
- Event Listing: View a list of upcoming events with details.
- Event Registration: Register for events you're interested in.
- Cross-Platform: Built with Kotlin Multiplatform, allowing the app to run on Android, iOS, and more.
The project is structured as follows:
androidApp
: Android-specific code and UI.iosApp
: iOS-specific code and UI (Swift/Kotlin Multiplatform).shared
: Shared Kotlin code.data
: Data layer, including event data and repositories.presentation
: Presentation layer, including view models and UI logic.resources
: Shared resources like images, fonts, and strings.
Before you begin, ensure you have the following installed:
- Android Studio with Kotlin support.
- Xcode for iOS development (if targeting iOS).
- IntelliJ IDEA or another Kotlin-friendly IDE for shared code development.
Clone this repository to your local machine:
https://github.com/furqanullah717/event-hub-kmm.git
## Build and Run
To run the Event Registration App, follow these steps:
- Build and run the Android app using Android Studio.
- Build and run the iOS app using Xcode.
## Usage
This project is designed to help you get started with Kotlin Multiplatform development and learn how to build a cross-platform event registration app. Here's how you can make the most of it:
- Define shared logic and data models in the `shared` module.
- Implement platform-specific UI using Compose in the `androidApp` and `iosApp` modules.
- Customize the app's functionality and UI to meet your learning goals.
- Experiment with additional features or improvements.
## License
This project is open-source and licensed under the MIT License. Feel free to use it as a learning resource or a starting point for your own projects.
## Contributing
We welcome contributions to this project! If you have ideas for enhancements or bug fixes, please create issues or submit pull requests. Your feedback and contributions will be greatly appreciated.
## Acknowledgments
Special thanks to the following technologies and tools that made this project possible:
- Kotlin Multiplatform
- Jetpack Compose
- Android Studio
- Xcode
## Contact
If you have any questions, need help, or want to connect with other developers working on similar projects, please don't hesitate to reach out to us.
Happy learning and coding! 🚀📱💻