CoviDash is a simple data visualisation web based app for displaying statistics for Covid-19 for a single country and its states (or provinces).
Country can only be chosen during setup.
- Latest Windows, Mac OS or Linux distro
- 5GB disk space
- PHP 7.4
- Apache 2.4
- Maria DB 10.2.6 (or MySQL 5.7)
- Composer
- Git
- PHP 7.2
- Apache 2.2
- Open your terminal or command line, navigate to the folder you want to install app to.
- Type
git clone https://github.com/aphoe/CoviDash.git
You can also go tohttps://github.com/aphoe/CoviDashto download the zip file.
This folder should be in your web server's websites root folder. - Open the folder of the app, make a copy of
.env.exampleand save it as.env.If you are you using MAMP on Mac, type
DB_SOCKET="/Applications/MAMP/tmp/mysql/mysql.sock"in the.envfile then save it. - Go back to the terminal (in the folder of cloned or download CoviDash app), run
composer install. Wait for it to finish. - Still in the terminal, run
php artisan key:generate. - Go to your MySQL terminal or phpMyAdmin, create a database for CoviDash.
Also note (or create) the database user and password for your MySQL server. - Open your browser and go to the URL of your app. You should see the setup page.
Wrongly filling any field in setup page, will ruin the app installation.
- If all goes well, you should see a login page. Login with the email and password you entered in the step above.
There is no direct link to the login page anywhere on the site, so you have to go to http://your-domain.ext/login to login.
To access the admin area, go to http://your-domain.ext/admin.
Provinces (or states) are added automatically during setup. You can add more if you need, or edit the ones there. If need be, you can deactivate a province. Deactivating a province means it will not show in the front end.
This is were you add, edit, or delete data related to incidences.
Instead of editing an already entered incidence, you can just create a new one with a counter value. For instance, if you added 25 critical state for a province, instead of 19, you can just create a new incidence with a value of -6, instead of editing the already saved incidence.
You can upload bulk data for a a day for all the provinces (aka states).
Users management on the app.
All users have the same privileges, so be mindful of who you add.
Create important links that will appear on the front end.
Post news articles and information URLs.
A sitemap at http://your-domain.ext/sitemap.xml is automatically generated. You can submit the link to RSS readers and search engines.
WARNING: Troubleshooting the app requires being an expert.
If you made any mistake during setup, you can attempt salvage the situation by editing the .env file, whose content would have changed.
This app can also be used to visualise other diseases and ailments. Go to .env and change the value of CODA_DISEASE
You can change logos by going to the public/theme/assets/img folder. Try to maintain the same dimension and colours for the newn images.
To change favicons, go to https://realfavicongenerator.net/
Download the images created and put them in public/theme/assets/img/favicons
CoviDash is released under MIT License.