https://github.com/unicef/iogt-pwa
A UNICEF-led digital solution transforming lives and providing opportunity, by making knowledge universally accessible.
https://github.com/unicef/iogt-pwa
django javascript-es6 progressive-web-app python-3 service-worker single-page-applications wagtail-cms
Last synced: 5 months ago
JSON representation
A UNICEF-led digital solution transforming lives and providing opportunity, by making knowledge universally accessible.
- Host: GitHub
- URL: https://github.com/unicef/iogt-pwa
- Owner: unicef
- License: other
- Created: 2020-04-26T09:40:38.000Z (almost 6 years ago)
- Default Branch: develop
- Last Pushed: 2023-01-08T00:28:06.000Z (about 3 years ago)
- Last Synced: 2025-07-26T23:12:09.915Z (7 months ago)
- Topics: django, javascript-es6, progressive-web-app, python-3, service-worker, single-page-applications, wagtail-cms
- Language: CSS
- Homepage: https://www.internetofgoodthings.org/
- Size: 12.4 MB
- Stars: 3
- Watchers: 13
- Forks: 2
- Open Issues: 46
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# iogt-pwa
## Documentation
Our [wiki](https://github.com/unicef/iogt-pwa/wiki) has several pages of information for developers, and people contributing to IoGT-PWA. Check it out for your authoritative source of information about the IoGT-PWA community.
## Local installation
#### Activate your virtual environment (backend)
```bash
$ virtualenv iogt
$ source iogt/bin/activate
```
#### Install necessary dependencies & setup database (backend)
```bash
git clone https://github.com/unicef/iogt-pwa.git
cd iogt-pwa/iogt
pip install -r requirements.txt
cd ..
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver
```
The demo site will now be accessible at [http://localhost:8000/](http://localhost:8000/) and the Wagtail admin
interface at [http://localhost:8000/admin/](http://localhost:8000/admin/).
Log into the admin with the credentials you set while creating the superuser account.
Use `Ctrl+c` to stop the local server.
#### Setup yarn package manager (Depends on [nodejs](https://nodejs.org/en/download/) environment)
```bash
# May require administrator privileges to the command
npm install -g yarn
```
#### Install necessary dependencies in a separate terminal window (frontend)
```bash
# Navigate to frontend folder
cd frontend
# Install frontend dependencies
yarn install
# Start a development server
yarn run dev
# Making a production build
yarn run build
```
Once the server has started, it will print a local development URL to open in your browser. Now you're ready to test drive IoGT website!
## Agile development cycle
IoGT development team follows an agile development cycle as illustrated below in the steps to deliver working software as quickly as possible.
## Questions
For questions and support please use the [community chat](https://discord.gg/phuq48). The [issue list](https://github.com/unicef/iogt-pwa/issues) of this repo is exclusively for bug reports and feature requests.
## Issues
Please make sure to read the [Issue Reporting Checklist](https://github.com/unicef/iogt-pwa/blob/master/CONTRIBUTING.md) before opening an issue. Issues not conforming to the guidelines may be closed immediately.
## Changelog
Detailed changes for each release are documented in the [release notes.](https://github.com/unicef/iogt-pwa/releases)
## Stay In Touch
- [Twitter](https://twitter.com/hashtag/iogt)
## Contribution
Please make sure to read the [contributing guide](https://github.com/unicef/iogt-pwa/blob/master/CONTRIBUTING.md) before making a pull request.
Thank you to all the people who already contributed to IOGT-PWA!
## License
[GNU AFFERO GENERAL PUBLIC LICENSE](https://github.com/unicef/iogt-pwa/blob/master/LICENSE)