JHipster React Native

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

Check out the blog post or YouTube video for a full demo of JHipster React Native.

Docs

• Getting Started
• Generators
• Project Structure
• Distributing and Updating Apps
• CLI Flags
• JHipster Integrations
  • OAuth 2.0 and OpenID Connect
  • WebSockets
• React Native Library Integrations
  • Expo - A framework and platform for universal React application
  • React Native Web - Run your React Native application in a browser, including PWA support
  • Storybook - Develop UI components in isolation
  • Detox - End-to-End Testing and Automation Framework for Mobile Apps
  • React Navigation - Routing and navigation for your React Native apps
  • Redux and Sagas - State management

Getting Started

Requirements

• Node LTS v16+
  • Verify version with node -v
• generator-jhipster-react-native installed
  • Install with npm install -g generator-jhipster-react-native
• eas-cli installed with npm install -g eas-cli
• To run your app on an emulator instead of a device, follow the platform-specific instructions:
  • Android
  • iOS
• JHipster backend must use jwt or oauth2 for its authenticationType

Usage

Generate React Native app from JHipster app

Create a JHipster app using jhipster, or a backend-only with jhipster --skip-client.

Create a directory alongside your JHipster app (ex. client), and run jhipster-react-native or rnhipster in it.

+ rootDir/
  + backend/ # run `jhipster` in it.
  + client/  # run `jhipster-react-native` or `rnhipster` in it.

Answer the prompts:

• Enter the path to your JHipster app (default: ../backend)
• Choose whether to enable E2E Detox Tests

Generate JHipster app and React Native app at the same time

You can also create a JHipster app and an React Native app at the same time using the following command:

jhipster jdl bug-tracker.jh --blueprints react-native

+ rootDir/
  + backend/ # run `jhipster` in it.

Answer the prompts:

• Enter the path to your React Native app (default: ../client)

For available options, you can run:

jhipster-react-native app --help

Configuration

• app/config/app-config.js contains your JHipster API URL (default: http://localhost:8080/)

CORS

• In dev, for the Web build, add http://localhost:19006 as an allowed origin in the backend CORS config.
• In production, you will need to enable CORS for your deployment domain.

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.

License

Apache-2.0 © Jon Ruddell