Welcome to Postage App! π
Postage App is a simple application that is used to find out shipping costs between regions throughout Indonesia. Built using Framework7. π
πΎ Requirements
Node.js
- used for the entire application development process. Whether it's making an API or somethingWeb Browser
- can be used as an emulator to build applications. Example [Chrome, Firefox, Safari & Opera]Internet
- because many use CDN and to make it easier to find solutions to all problemsComposer
- make it easier for developers to manage PHP project dependenciesAndroid SDK
- to simplify the process of building applicationsGradle
- function to perform application building automaticallyJava Development Kit
- used for support in developing or building an application
π― How To Use
Using the built-in ready to use from the release (Recommended)
Download the latest project release from the Release Page. Open the Postage App project folder using a terminal and type npm run dev
. To explore the source code you can use a text editor such as Visual Studio Code.
Build manually
- Before starting, make sure you have Node.js installed first
- If you have installed Node.js. Run the command git clone which is
https://github.com/RizkiKarianata/postage-app
- Install the dependencies using the node package manager of your choice. For example run
npm install
in terminal - To run the application you can run the command
npm run dev
. And the application will automatically open using port 8080 on your default browser
Build to APK
- You can run commands like in the
NPM Scripts
below by addingnpm run
. Examplenpm run build-dev-cordova-android
on terminal
π NPM Scripts
- π₯
start
- run development server - π§
dev
- run development server - π§
build-dev
- build web app using development mode (faster build without minification and optimization) - π§
build-prod
- build web app for production - π±
build-dev-cordova
- build cordova app using development mode (faster build without minification and optimization) - π±
build-prod-cordova
- build cordova app - π±
build-dev-cordova-ios
- build cordova iOS app using development mode (faster build without minification and optimization) - π±
build-prod-cordova-ios
- build cordova iOS app - π±
build-dev-cordova-android
- build cordova Android app using development mode (faster build without minification and optimization) - π±
build-prod-cordova-android
- build cordova Android app
π Documentation & Resources
- Framework7
- Apache Cordova
- Node.js
- Download Postage App - Mediafire
- Did you build a framework or other features? Open up Pull Requests and put yours here! π
π Release Date
- v1.0.0 : 06 June 2022
π§ Author
- Facebook : Rizki Karianata
- Instagram : @rizkikarianata
- Youtube : @rizkikarianata
- LinkedIn : @rizkikarianata
π€ Contributing
I really appreciate contributions, issues and feature requests because this application is far from perfect. Feel free to Pull Request and make changes to this project.
Since this is an open source project I finished it myself. There may be many features or things that could be improved or added. So I really appreciate your help.
Steps To Contribute
- Fork it ( https://github.com/RizkiKarianata/postage-app )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Notes To Contribute
Make sure to not commit generated files from your dist folder. All changes need to be made in the source files located in the src
folder.
- Change the
scss
files to adapt styles - Change the nunjucks based
html
files or the content definingjson
files to adapt layout and content - Change the
js
files to adapt the application code
Always run a build and test the results before committing.
π License
- Copyright Β© 2020 Rizki Karianata
- Postage App is an open source project licensed under the MIT license
βοΈ Suppport & Donation
Love Postage App? Support this project by donating or sharing with others in need.
Made with β€οΈ Rizki Karianata