This is a collection of tutorials and demos. For a full listing of the packages, please see the PACKAGES.md file.
There are two different ways to build and use the demos in this repo:
- Copy individual packges to their own directory. This strategy works best if you do not have access to the full Ionic Security Trifecta and want to run one of the demos that only uses dependencies you have access to. See the Build a Stand-alone Project section for details.
- Build within this monorepo using this
pnpm. This strategy works best of you do have access to the full Ionic Security Trifecta and understand the use ofpnpm. See the Build All section for details.
If you do not have access to the full suite of @ionic-enterprise packages used by these demos, you may still be
able to build specific demos. For example, if you only have access to Auth Connect, you can build the demos that
only depend on Auth Connect.
Here is an example of doing this for the demo-iv-ac demo, which uses Identity Vault and Auth Connect:
- Clone this repo
cd tutorials-and-demos-vuecp -r demos/iv-ac ..cd ../iv-ac- Copy your
.npmrcfile. Some demos, such as thetea-tasterdemo, do not depend on any@ionic-enterprisepackages. For such items, you can skip this step. npm inpm run buildnpm run dev- etc...
Note: you can still use pnpm commands rather than npm commands if you desire.
In order to install and build from this repo, you will need:
- pnpm
- Make sure you have access to Auth Connect, Identity Vault, and Secure Storage. Also, make sure you have previously
registered an application using the
ionic enterprise registercommand (which generates an .npmrc file). Copy the generated file to the root of this project.
If you have purchased access to all three solutions in the Security Trifecta, it is easiest to build all of the demos and tutorials as a set. To do so:
- Clone this repo
cd tutorials-and-demos-vue- Copy your
.npmrcfile to the root of this project if you have not done so yet (see above). pnpm ipnpm test(optional)pnpm build
You are now ready to run any of the individual demos following the instructions in the next section.
All projects contain the following scripts:
dev: Run the package in the development server so it can be accessed via the web browser.android: Load the package in Android Studio for deploying to a device or simulator.ios: Load the package in Xcode for deploying to a device or simulator.
Use the --filter option to specify a package. For example, if you are interested in running demo-tea-taster use any
of the following commands:
pnpm --filter demo-tea-taster devpnpm --filter demo-tea-taster androidpnpm --filter demo-tea-taster ios
For more advanced uses of the Ionic or Capacitor CLIs you can also change to the package's directory and run them from there.
To develop any if the projects within the mono-repo, use the --filter option with a couple of standard scripts.
For example, to work on the demo-tea-taster demo, open a couple of terminal sessions and run the following commands:
pnpm --filter demo-tea-taster devpnpm --filter demo-tea-taster test:dev
Some of these applications use live backend APIs that require a login. In such cases, unless you have been given your own credentials, please use the following:
- email:
test@ionic.io - password:
Ion54321
Happy Coding!