This material is meant to be used in conjunction with the Ionic Enterprise Training courses offered to our customers. The applications and labs contained within are some of the applications that are built during this course. This deck by no means contains all of the information provided in the course.
To run this deck on your machine:
git clone https://github.com/ionic-team/ionic-training-decks.git
cd ionic-training-decks
npm install
npm start
At this point, the training decks application should be running in your browser, allowing you to follow along with the specific labs.
This is also available online as a PWA that you can either run in the browser or install on your device: https://ionic-training-decks.firebaseapp.com
Adding or updating trainings should not require a change to any of the source code. Here are some key points to help get started:
src/assets/data/markdown
.src/assets/data/menu.json
file. The entry must have a title
and file
. It should also have an icon
. If it is a multi-page training, it should also have a folder
and list of pages
. The pages
are navigated via the navigation controls in the header of the application in the order in which they are specified.The menu.json
entry for a multi-page training looks like this:
{
"title": "Identity Vault",
"folder": "identity-vault-capacitor",
"file": "intro",
"icon": "lock-closed",
"pages": [
{
"title": "The Base Application",
"file": "base"
},
{
"title": "Identity Service",
"file": "identity-service"
},
{
"title": "Make it Work in the Browser",
"file": "browser-service"
},
{
"title": "Add Biometrics to Login",
"file": "biometrics"
},
{
"title": "Customize the PIN Dialog",
"file": "custom-pin"
}
]
},
The menu.json
entry for a simple single-page training looks like this:
{
"title": "A Simple git Workflow",
"file": "simple-git-workflow",
"icon": "git-branch"
},
The trainings will be displayed in the main menu in the order in which they are specified.
Given the structure of the application, please only go one level deep with the trainings. That is, do not try and nest a list of pages on a page within a specific page on a training. That used to work in older versions of this application, but supporting it makes the UI overly complex and is a feature that was never used.
npx changeset
) so the version is bumped properly.There are no real rules on the versioning, but basically follow something logical. For example:
patch: Fixes to the application or trainings.
minor: New trainings added or whole new sections added to trainings.
major: Trainings removed or changed is such a significant was as to be considered "breaking."
If there is a question, don't sweat it, just pick what seems best to you.
main
branch.main
and that you have all changes from origin
.firebase
as the support@ionic.io
userOnce you have done that:
npm run bump
to apply the changesets.git commit
for the release.npm run build
firebase deploy