Ignite JHipster

A React Native boilerplate for JHipster apps, complete with authentication, an entity generator, JDL support, E2E tests, and more.

Check out the Sample Application for Android or the presentation at JHipster Conf on YouTube.

Docs

• Getting Started
• Generators
• Project Structure
• JHipster Integrations
  • OAuth2 OIDC Login
  • Websockets
• React Native Integrations
  • Storybook - Develop UI components in isolation
  • fastlane - Automate building and releasing your mobile apps
  • Detox - End-to-End Testing and Automation Framework for Mobile Apps
  • React Native Navigation - A complete native navigation solution
  • Redux and Sagas - State management
• Advanced Usage

Getting Started

Requirements

• Node v8+
  • Verify version with node -v
• React Native CLI setup
• ignite-cli installed (>= v2.0.0)
  • Install with npm install -g ignite-cli
  • Verify version with ignite --version
• Mac users require CocoaPods to be installed
  • Verify pod installation with pod install
• Not required but highly recommended, Reactotron makes debugging much easier and comes pre-configured

To generate an app, run the following command:

ignite new SampleApp --boilerplate ignite-jhipster

Answer the prompts, entering the path to your JHipster app and choosing any plugins you want. The generator will create a new directory containing the project (preconfigured for both iOS and Android).

After generating, you can use the entity generator, JDL importer, and other commands.

Configuration

app/config/app-config.js contains several important variables:

• apiUrl: Your JHipster app's API url
• appUrlScheme: Your app's URL scheme for deep-linking, this is also configured for iOS (Info.plist) and Android (AndroidManifest.xml) separately.
• uaaBaseUrl: (UAA only) If you use a uaaBasePath other than uaa, configure this variable

Notes for Android

• When running your JHipster backend locally for Android, make sure to run adb reverse tcp:8080 tcp:8080 so the app can communicate with your backend.
• When building the Android app manually, prepend app: to the command (due to React Native Navigation). For example: ./gradlew app:bundleRelease