How to use this template?
Learn which is the best way for you to use this template. There are two ways: as a starter app or as a toolbox.
First of all, please make sure you followed the Set up the development environment and Running the app sections.
As a starter app
If you plan to use many of the pages and features offered by the template, then you could use the template as a base to create your app.
This means that the template is itself an Ionic app, so you don't need to create another app.
You can use the template as a base for your app and just delete the pages you don't want, and customize them to create your own and unique app.
As a toolbox
If you only want to use some specific pages or components and you already have an existing Ionic App, then it would be better for you to just import the features and components your need into your existing app.
If you want to start with a small portion of the template, just with the initial authentication screens, and the tabs and side menu navigation just send us an email to [email protected] including your github username and we will share the repo with you.
Import some pages into your existing Ionic Application
How to do this? Let's assume you want to add the Contact Card page (and all its styles) to you app.
Copy the page folder
Copy the entire contact-card folder from
src/app/contact-cardApp Shell
Copy the utils folder which includes the shell files from
src/app/shellEnvironment
Add the following code into your
environment.ts file:1
appShellConfig: {
2
debug: false,
3
networkDelay: 0
4
}
Copied!
Theme
If you didn't change the
theme folder from your existing app, then delete it and copy the entire theme folder from the template.If you did change the
theme folder from your existing app, then just copy the rest of the files from the theme folder expect the variables.scss file. Then open this file and add the styles we set for the template such as the font-family and the margins.Components
If you want to use any of the custom components then copy all the components folder from
src/app/components and import the module from the AppModule.Note that we use dayjs library for the countdown components, so if you want to use it you need to install it by running:
npm install [email protected] --saveRouting
Add the new route to your routing file such as
src/app/app-routing.module.tsIcons
We designed many custom icons for this template and you are free to use them if you like. All of them are located in the
src/assets/sample-icons folder. If you want to use them you need to include them in your project.angular.json file
Add the following code into your
angular.json file just before the "styles": ["src/theme/variables.scss", "src/global.scss"]1
....
2
"stylePreprocessorOptions": {
3
"includePaths": [
4
"src"
5
]
6
},
7
....
Copied!
We are currently recording videos showing how to use the different tools from the template into your own Ionic App.
Want to suggest any specific topic? Send us an email to [email protected]
Additional resources
We are creating different projects with smaller portions of the template to help you getting started. If you want access to any of them send us an email to [email protected] including your github username and we will share the repo with you. Currently we have:
- Ionic Full Starter App Basic Simplified: this is a simplified version of the template without App Shell and without the perceived performance improvements from the App Shell solution. Thus, the data resolvers are simpler.
- App Shell Components: a project that will help you understand how to use the template app shell components in your own Ionic app.
- Firebase Starter: in progress.
Last modified 4mo ago