IDEA Ionic extra

IDEA's extra components and services built on Ionic 8, and distributed with different NPM packages.

The last version fully compatible with Ionic 7 is v7.3.0. The last version fully compatible with Ionic 6 is v6.13.0. The last version fully compatible with Ionic 5 is v5.29.4.

Packages

Documentation.

• common
• agenda
• auth
• auth0
• barcode
• editor
• teams
• uncommon

Use

To use a module in a project, install it through NPM (together with its dependencies):

npm i --save @idea-ionic/<module>

Make sure to install to follow the instructions of each specific module.

Develop

This is a single Angular CLI workspace: every dependency lives in the root package.json, and the libraries are built from the root — sibling @idea-ionic/* packages resolve from the locally-built dist/ via tsconfig paths. The per-module package.json files only declare what consumers need (peer dependencies); they are not meant to be installed individually.

Install once, from the repository root — do not run npm i inside modules/*:

npm ci

Build the libraries in dependency order (common and uncommon first); build:all encodes that order:

npm run build:all      # build every module, in order
ng build common        # or a single module — build its @idea-ionic/* dependencies first

Lint and format:

npm run lint
npm run format         # write changes; or `npm run format:check` to verify

Release

Note well: before to release, test everything and make a pull request with the changes to be approved.

Note: the versions of this lib's modules should advance together (Angular's standard); therefore, all the modules (also unchanged ones) will publish a new version!

To release a new version, make sure all the files are committed, then run (depending on the version type):

./publish.sh major|minor|patch

Then, commit the changes (commit message: vX.Y.Z).