README.md

live_people_app

Manage people with channel model bindings and vue.js

See it live! https://live-people-app.herokuapp.com/

Features

• 3 way model binding. All clients are in sync all the time.
• Uses Django Channels / model binding to push model changes.
• Uses vue.js for a lightweight interactive experience.

 

• vue.ModelForm class providing vue integration with django's forms for validation and data cleaning.

  • see live_people_app/utils/vue.py

• Management command that periodically resets the database and syncs & notifies connected clients of the update.

  • see live_people_app/people/management/commands/populate.py

• (Technical Jargon:) Custom websocket reply channel consumer that allows individual clients to request information from the server via websocket.

  • see live_people_app/utils/consumers.py

• Custom Reconnecting WebSocket object

  • see live_people_app/static/js/project.js

• Vue.js integration

  • see live_people_app/people/templates/people/home.html

• Not TOTALLY ugly (it is). I like this live icon:

  

Up and Running

1. git clone [email protected]:bionikspoon/live_people_app.git
2. cd live_people_app
3. pipenv --python 3.7
4. pipenv install --dev
5. docker-compose up -d
6. cp env.example .env
7. ./manage.py migrate
8. ./manage.py runserver