Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fossasia/open-event-attendee-ios

iOS app for open event
https://github.com/fossasia/open-event-attendee-ios

Last synced: 2 months ago
JSON representation

iOS app for open event

Awesome Lists containing this project

README

        

| **CircleCI** | **Code Quality** | **Chat** |
|--------------|------------------|----------|
| [![CircleCI](https://circleci.com/gh/fossasia/open-event-ios.svg?style=svg)](https://circleci.com/gh/fossasia/open-event-ios) | [![Codacy Badge](https://api.codacy.com/project/badge/Grade/4faa165463a44fffbd23f319d78a26ea)](https://www.codacy.com/app/mb/open-event-ios?utm_source=github.com&utm_medium=referral&utm_content=fossasia/open-event-ios&utm_campaign=badger) | [![Join the chat at gitter](https://badges.gitter.im/fossasia/https://github.com/fossasia/open-event-ios.svg)](https://gitter.im/fossasia/https://github.com/fossasia/open-event-ios?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) |
# Open Event iOS
**iOS** app for **Open Event**
![Open Event](https://storage.googleapis.com/eventyay.com/assets/branding/base_branding.png)

## Introduction
> This is an iOS app developed for `FOSSASIA` in mind. The Open Event Project offers event managers a platform to organize all kinds of events including concerts, conferences, summits and regular meetups.

## Roadmap

Make the app functionality and UI/UX similar to the android app for Open Event.

## Communication

**Please join our mailing list to discuss questions regarding the project :-**

> *https://groups.google.com/forum/#!forum/open-event*

**Our chat channel is here :-**

> *https://gitter.im/fossasia/open-event-ios*

## Things To Have
1. **[Xcode](https://developer.apple.com/xcode/)**
2. **[CocoaPods](http://cocoapods.org/)**

### Libraries used and their documentation

- Material [Docs](https://cocoapods.org/pods/Material)
- Pages [Docs](https://github.com/hyperoslo/Pages)
- Toast-Swift [Docs](https://github.com/scalessec/Toast-Swift)
- SwiftyJSON [Docs](https://github.com/SwiftyJSON/SwiftyJSON)
- Alamofire [Docs](https://github.com/Alamofire/Alamofire)
- DateTools [Docs](https://github.com/MatthewYork/DateTools)
- MGSwipeTableCell [Docs](https://github.com/MortimerGoro/MGSwipeTableCell)
- DZNEmptyDataSet [Docs](https://github.com/dzenbot/DZNEmptyDataSet)
- SwiftValidators [Docs](https://github.com/SwiftValidatorCommunity/SwiftValidator)
- IQkeyboardManagerSwift [Docs](https://github.com/hackiftekhar/IQKeyboardManager)

## Development Setup

Before you begin, you should already have the Xcode downloaded and set up correctly. You can find a guide on how to do this here: [Setting up Xcode](https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppStoreDistributionTutorial/Setup/Setup.html)

#####        Steps to install Cocoapods (one time installation)

- Run `sudo gem install cocoapods` to install the latest version of cocoapods. To install cocoapods from HomeBrew, run `brew install cocoapods`.

- Next, run `pod setup` for setting up cocoapods master repo. You may include `--verbose` for more descriptive logs.
**NOTE:** This might take a while to setup depending on your network speed.

## Setting up the iOS Project

1. Download the _open_event_ios_ project source. You can do this either by forking and cloning the repository (recommended if you plan on pushing changes) or by downloading it as a ZIP file and extracting it.

2. Navigate to the unzipped folder and run `pod install`.

3. Open `FOSSAsia.xcworkspace` from the folder.

4. Build the project (⌘+B) and check for any errors.

5. Run the app (⌘+R).and test it.
# Contribute!

> You're now ready to contribute!

Before writing any code, We will highly recommend to have a look at the [Contribution Guidelines](CONTRIBUTING.md) to avoid any unnecessary conflicts. For contributors new to Git please have a look at the [Git Configuration commands](docs/gitconfiguration.md) .

## License
This repository is licensed under the **[MIT License](LICENSE)**.
> To obtain the software under a different license, Please contact **FOSSASIA**.