/dx-mobile

A Flutter powered iOS and Android app to help maintainers manage multiple repos on the go.

Primary LanguageDartMIT LicenseMIT

SendGrid Logo
MIT licensed

DX Mobile

A new Flutter project to manage multiple high-demand repositories on the go.

Credits and References

Emily Fortuna - Dude, where's my pull request?
Adrian Ivascu - Dashboard concept
Git Pull Request Icon (svg file) - original image owned by GitHub
Git Branch Icon (svg file) - original image owned by GitHub

Getting Started

For help getting started with Flutter, view our online documentation.

Flutter Installation

Please download this version of the Flutter SDK specifically - v0.9.4
Mac | Windows | Linux

Setting it up

You'll need:
- installation of Flutter v0.9.4
- an emulator (Android or iOS)
- a GitHub API token (get yours here)
- cloned local copy of this repo

The Flutter installation includes XCode (for Mac only) and Android Studio (Windows/Linux/Mac). If you're using a Mac and not sure if you have the Xcode command line tools, run this command: $ xcode-select --install

If you run into some flutter doctor issues/errors, try running these commands:

$ brew update && brew upgrade
$ brew install --HEAD libimobiledevice
$ brew install ideviceinstaller
$ brew install ios-deploy
$ brew install cocoapods
$ pod setup

After installing Flutter, use Terminal or PowerShell and change directories to the dx_mobile directory you just cloned.

$ cd dx-mobile

Then, launch any emulator. See the Flutter setup page (Mac | Windows | Linux) for instructions on how to set up your emulators (for Android emulators, you'll need to launch it initially from Android Studio's AVM). To start an iOS simulator, run this command:

$ open -a Simulator

If you're having issues finding the AVD Manager in Android Studio, click here

To see the emulators you have open, run this command:

$ flutter emulators

As an example, if you have an emulator called pixel2, type this in your terminal:

$ flutter emulators --launch pixel2

After that, open the project directory up in any IDE and in the lib/github directory, create a file called token.dart (add this file to your .gitignore file) and add what's below into the file. This will be used to authenticate with GitHub.

const token = 'YOUR_GITHUB_API_TOKEN';

Once your emulator is running, run the app! Flutter should automatically get the dependencies and packages for you.

$ flutter run

If you have multiple emulators running, you can run the app on all the devices at once by using this command.

$ flutter run -d all

About

dx-mobile is primarily authored by Agnes Jang and guided and supported by the SendGrid Developer Experience Team.

dx-mobile is maintained and funded by SendGrid, Inc. The names and logos for dx-mobile are trademarks of SendGrid, Inc.

License

The MIT License (MIT)