Skip to content

furqanullah717/event-hub-kmm

Repository files navigation

Event Registration App

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.

Features

  • 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.

Project Structure

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.

Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

Clone the Repository

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! 🚀📱💻

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published