Welcome to the Ionic Angular Cordova Starter Kit! This starter kit is designed to help you quickly get started with building mobile applications using Ionic, Angular, and Cordova. It provides a solid foundation for creating cross-platform mobile applications, whether you're targeting iOS, Android, or the Web.
Clone this repository to your local machine:
git clone https://github.com/tortuc/ionic-angular-cordova-starter-kit.git
cd ionic-angular-cordova-starter-kit
Run the following command to install the necessary dependencies for the project:
npm install
To run the app in the browser for testing and development:
ionic serve
This will start a development server and open the app in your browser.
You can run the app on a connected mobile device or an emulator using Cordova. First, ensure your mobile development environment is properly set up (either Android Studio for Android or Xcode for iOS). Then, use the following command:
ionic cordova platform add android
ionic cordova run android
ionic cordova platform add ios
ionic cordova run ios
To build the app for production, use the following command:
ionic cordova build --prod
This will generate an optimized production build of the app for either Android or iOS.
The general folder structure for this starter kit is as follows:
/src
/app - Core app code (components, services, pages)
/assets - Static assets (images, icons, etc.)
/environments - Configuration for different environments (dev, prod)
/theme - Global styling and theme variables
You can customize the app by editing the following:
- Pages: Modify or add new pages in /src/app/pages.
- Services: Modify or create new services for API calls or data management in /src/app/services.
- UI Components: Modify existing UI components or create your own in /src/app/components. For styling, you can use CSS or SCSS files located in the /src/theme folder. Ionic uses a highly customizable design system with pre-built components, so you can easily adjust the app's look and feel.
You can run unit tests using the following command:
ng test
For end-to-end testing, use:
ng e2e
After building the app for production, you can deploy it to the respective app stores:
- Android: Use Android Studio to upload the APK to the Google Play Store.
- iOS: Use Xcode to upload the app to the Apple App Store.
Feel free to fork this repository and submit pull requests if you'd like to contribute. Please ensure you follow the coding guidelines and submit a description of the changes made.