ionic-team / ionic-enterprise-starter

A free starter app for activating Ionic's Secure Solutions. Comes pre-configured with Ionic Identity Vault, Auth Connect, and Secure Storage.

Ionic Secure Solutions Starter

A showcase app of Ionic App Platform technologies, including Ionic Framework, Capacitor, Appflow, and Ionic Secure Solutions solutions.

Login Page	Account Page

Try the App

To log into Ionic Secure Solutions Starter, use username [e-mail] and password: ionic.

Tutorial

Want to see how the Ionic Secure Solutions Starter was made? Follow along the step-by-step tutorial.

Tech Details

• Native runtime: Capacitor 4
• Frameworks: Ionic Framework 6 and Angular 14
• Capacitor Core plugins
• Ionic Secure Solutions: Auth Connect, Identity Vault, Secure Storage

How to Run

Note: Installing and running this app requires an Ionic Enterprise Native key from a Ionic Standard or Ionic Enterprise subscription or trial. To use authentication, an Auth0 App is required.

Want to try Ionic's Secure Solutions in your app? Sign up for a free trial.

• Install the Ionic CLI: npm install -g @ionic/cli
• Clone this repository: git clone https://github.com/ionic-team/ionic-enterprise-starter.git
• Navigate to repo in a terminal: cd ionic-enterprise-starter
• Add an Ionic Enterprise Native key as an Environment Variable using your preferred method:
  • Add to Bash or Zsh configuration file
  • Set in terminal with export ENT_NATIVE_KEY="key_4e9d5..."
  • You can find your key in your Ionic Hub under "Native Plugin Keys" (Native Solutions > Auth Connect > Get Started for personal accounts). More details here.
• Install dependencies (this will fail if you don't have an Ionic Enterprise Native key): npm i
• OPTIONAL: Update the clientID and domain within the discoveryURL in the auth0Config in your environment.ts file using your Auth0 App details.
  • If you have AUTH0_CLIENT_ID and AUTH0_DOMAIN set as environment variables locally, you can run npm run prebuild:dev to update the file automatically.
  • This is required to log in to the app. More details here.
• Run locally in a browser: ionic serve
• Deploy to a mobile device: See details here.