ColombiApp is a mobile application developed with Ionic 8 for learning purpose and public use as an open source application open to improvements.

The app makes requests to an also free and open source API called api-colombia

See API documentation here

Steps to run project in local browser:

1. Clone project git clone https://github.com/rortizv/colombiapp.git
2. In project's folder, open a terminal.
3. Make sure you're using Node +18.
4. Run in terminal: npm i to install node modules.
5. Run project with: ionic serve
6. Application will open in browser at http://localhost:8100
7. Since the app was designed for mobile only, it is recommended to try running on browser, opening the Dev Tools and changing the view to mobile for a correct user experience.

Do you want to contribute to this project?

Easy as following these steps:

1. Fork the Repository: click the "Fork" button in the top-right corner. This creates a copy of ColombiApp's repository under your GitHub account.
2. Clone the Forked Repository: After forking, you should clone the forked repository to your local machine using Git. This allows you to make changes locally.
3. Create a Branch: Within your local repository, create a new branch to work on your changes. This helps keep changes isolated and makes it easier to manage multiple contributions.
4. Make Changes: make your changes to the codebase.
5. Commit Changes: Once you have made your changes, commit them to your local branch with descriptive commit message.
6. Push Changes to Fork: After committing your changes locally, push your branch to your forked repository on GitHub. This makes your changes available remotely.
7. Submit a Pull Request: Finally, navigate to your forked repository on GitHub and click the "New pull request" button. You'll need to select the branch containing your changes and specify the branch you want to merge into in the original repository. After creating the pull request, please provide a description explaining the purpose of your changes.