KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

PokeMap-iOS

★ 39 Open GitHub ↗

Pokemon Go Map for iOS with Local Notifications

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

PokeMap
=================

[![Swift 2.2](https://img.shields.io/badge/Swift-2.2-orange.svg?style=flat)](https://developer.apple.com/swift/)
[![Platform iOS](https://img.shields.io/badge/Platforms-iOS-lightgray.svg?style=flat)](https://developer.apple.com/swift/)
[![Build Status](https://travis-ci.org/PokeMapCommunity/PokeMap-iOS.svg?branch=master)](https://travis-ci.org/PokeMapCommunity/PokeMap-iOS)
[![codecov](https://codecov.io/gh/PokeMapCommunity/PokeMap-iOS/branch/master/graph/badge.svg)](https://codecov.io/gh/PokeMapCommunity/PokeMap-iOS)
[![codebeat badge](https://codebeat.co/badges/39faf839-6cd3-42df-bc15-02ab48aab5c4)](https://codebeat.co/projects/github-com-pokemapcommunity-pokemap-ios)
[![GitHub issues](https://img.shields.io/github/issues/PokeMapCommunity/PokeMap-iOS.svg?style=flat)](https://github.com/PokeMapCommunity/PokeMap-iOS/issues)
[![License MIT](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/PokeMapCommunity/PokeMap-iOS/blob/master/LICENSE)

PokeMap is a companion app for Pokemon Go. PokeMap allows you to track Pokemon locations by navigating a map or by sending you local notifications for watchlisted Pokemons near you!

![MapScreenshot](https://github.com/PokeMapCommunity/PokeMap-iOS/blob/master/Resources/MapScreenshot.png?raw=true) ![WatchlistScreenshot](https://github.com/PokeMapCommunity/PokeMap-iOS/blob/master/Resources/WatchlistScreenshot.png?raw=true)

## Getting Started

Run the following two commands to install Xcode's command line tools and bundler, if you don't have that yet.

```bash
[sudo] gem install bundler
xcode-select --install
```

The following commands will clone the repo and install all the required dependencies.

```bash
git clone https://github.com/PokeMapCommunity/PokeMap-iOS.git
cd PokeMap-iOS
bundle install
bundle exec pod install
```

Now you can open `PokeMap.xcworkspace` and Run the `PokeMap` target onto your simulator or iOS device.

You can also run the tests by calling:

```bash
bundle exec fastlane ios test
```

## Code style

This project will follow the [GitHub Swift Styleguide](https://github.com/github/swift-style-guide) in every way possible.

In order to enforce this, the project will also have a [Swiftlint](https://github.com/realm/SwiftLint) build phase to run the linter everytime the app is built.

Variable naming conventions will be ignored whenever a **RxSwift**-based variable is created (as the naming convention of the library is to start it with **rx_** (e.g. `rx_contentOffset`).

## Project Structure

The project follows this folder structure:

```
PokeMap
├── App
│   └── AppDelegate
├── Enums
├── Extensions
├── Externals
├── Globals
├── Helpers
├── Models
├── Networking
├── Protocols
├── Resources
│   ├── LaunchScreen.storyboard
│   ├── Localizable.strings
│   └── Info.plist
├── Structs
├── ViewControllers
│   └── Main
│         └── Main.storyboard
├── ViewModels
└── Views
```

In order to enforce it to the filesystem we're using [Synx](https://github.com/venmo/synx) to keep the folder structures clean and mirroring the project structure.

## Dependencies

### Model

- [ObjectMapper](https://github.com/Hearst-DD/ObjectMapper): Simple JSON Object mapping written in Swift
- [DateTools](https://github.com/MatthewYork/DateTools): Dates and times made easy in Objective-C

### Functional Reactive Programming

- [RxSwift](https://github.com/ReactiveX/RxSwift): Reactive Programming in Swift
- [NSObject+Rx](https://github.com/RxSwiftCommunity/NSObject-Rx): Handy RxSwift extensions on NSObject, including rx_disposeBag
- [Cell+Rx](https://github.com/ivanbruel/Cell-Rx): Handy RxSwift extensions on UITableViewCell and UICollectionViewCell, including rx_reusableDisposeBag
- [RxOptional](https://github.com/RxSwiftCommunity/RxOptional): RxSwift extensions for Swift optionals and "Occupiable" types
- [RxDataSources](https://github.com/RxSwiftCommunity/RxDataSources): Table and Collection View Data Sources for RxSwift

### Networking
 
- [Moya](https://github.com/Moya/Moya): Network abstraction layer written in Swift
- [Moya-ObjectMapper](https://github.com/ivanbruel/Moya-ObjectMapper): ObjectMapper bindings for Moya and RxSwift
- [Result](https://github.com/antitypical/Result): This is a Swift µframework providing Result
- [RxAlamofire](https://github.com/RxSwiftCommunity/RxAlamofire): RxSwift wrapper around the elegant HTTP networking in Swift Alamofire
- [SDWebImage](https://github.com/rs/SDWebImage): Asynchronous image downloader with cache support as a UIImageView category

### UI Components

None at the moment

### Utilities

None at the moment

### Environment

- [SwiftLint](https://github.com/realm/SwiftLint): A tool to enforce Swift style and conventions.
- [Fabric](https://docs.fabric.io/apple/fabric/overview.html): Fabric is a mobile platform with modular kits you can mix and match to build the best apps
- [Crashlytics](https://fabric.io/kits/ios/crashlytics/install): The most powerful, yet lightest weight crash reporting solution
- [Synx](https://github.com/venmo/synx): A command-line tool that reorganizes your Xcode project folder to match your Xcode groups
- [Fastlane](https://github.com/fastlane/fastlane): The easiest way to automate building and releasing your iOS and Android apps

### Testing

- [Quick](https://github.com/Quick/Quick): The Swift (and Objective-C) testing framework.
- [Nimble](https://github.com/Quick/Nimble): A Matcher Framework for Swift and Objective-C

In order to run the tests execute:

```bash
bundle exec fastlane ios tests
```

## Continuous Integration

We are using [Travis](https://travis-ci.org/PokeMapCommunity/PokeMap-iOS) alongside [Fastlane](https://fastlane.tools/) to perform continuous integration both by unit testing and deploying to [Fabric](https://fabric.io) or [iTunes Connect](https://itunesconnect.apple.com) later on.

### Environment variables

To make sure Fabric and iTunes can deploy, make sure you have them set to something similar to the following environment variables. **The values are only examples!**.

#### Fabric deployment

- `POKEMAP_SIGNING_IDENTITY_DEV`: iPhone Developer: Ivan Bruel (ID)
- `POKEMAP_FABRIC_CLIENT_ID`: API Key from [Fabric Organization](https://www.fabric.io/settings/organizations)
- `POKEMAP_FABRIC_SECRET`: Build Secret from [Fabric Organization](https://www.fabric.io/settings/organizations)

#### iTunes deployment

- `POKEMAP_SIGNING_IDENTITY_PROD`: iPhone Distribution: Company Name (ID)
- `POKEMAP_ITUNES_TEAM_ID`: Team ID from [iTunes Membership](https://developer.apple.com/account/#/membership)

### Deployment

Although all the deployment is done through Travis, you can do it manually through [Fastlane](https://github.com/PokeMapCommunity/PokeMap-iOS/blob/master/fastlane/README.md):

#### Deployment to Fabric

```bash
bundle exec fastlane ios fabric
```

### Deployment to iTunes Connect

```bash
bundle exec fastlane ios itunes
```

PokeMap-iOS

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README