Auxilium is an open-source app for reporting emergencies. It informs nearby users that an emergency has occured in their vicinity, and provides them with the location (and directions), to keep them informed, and take neccessary actions.
In my country, many people die because of inability to access help quickly when they are involved in accidents or emergencies. I've always believed that many of these mortalities could have been averted, if people around would have come to their aid.
This project is currently in the pre-launch phase, being developed by Oluwakorede Fashokun and members of the Overt community for Overt, a concept that creates open-source software to solve many of the problems we face in the world. You can read more here, or follow Overt on Twitter here.
You can share your ideas for the project in the Overt Discord server. You can also create feature requests as issues on this GitHub repository.
This section will help you get Auxilium up and running in your development environment.
Before starting installing, the following are required:
- Node.js (version 8 or higher).
- Yarn (version 1.22 or lower)
- MongoDB (database for local development)
Note that reading the package-specific docs is crucial to get Auxilium up and running locally.
You can check each of the packages in the packages folder for their respective READMEs.
To install Auxilium on your machine, run these commands:
# Clone the repository
git clone https://github.com/overthq/Auxilium.git
# Move into the project directory
cd Auxilium
# Install dependencies
yarn
cd packages/server && yarn
# SERVER-SIDE (Be sure to read the server docs)
# Start MongoDB
# Start the backend server (after including the necessary vars in the server's .env file)
yarn dev:server
# CLIENT-SIDE
# Start the Expo app
yarn dev:appAll forms of (positive) contribution is welcome to Auxilium. Be sure to check out the contribution guidelines before contributing.
Auxilium is a JavaScript-based application. It is built with popular JS libraries/frameworks like React, React Native and Express. Here's what the stack looks like.
- Front-End
- Mobile App
- Framework: React Native based on Expo
- Dashboard (not in active development)
- Library: React based on Create React App
- Mobile App
- Back-End
The continuous integration/deployment (CI/CD) on this project is handled with GitHub Actions.
GNU GPLv3 License
Oluwakorede Fashokun ([email protected]) for Overt.