A personalized fitness app where you can compete with your friends (and foes ๐)
Before getting started you should have the following installed and running:
- Git - insructions
- Yarn - instructions
- Vue CLI 3 - instructions
- Python 3 - instructions
- Fork this repo into your account
- Clone your repo
$ git clone https://github.com/<your-github-username>/GetFit
- Go inside this directory in your system (terminal-macos/linux or powershell-windows)
$ cd GetFit
Now let's install the dependencies
macOS/linux:
$ yarn install
$ python3 -m venv venv
$ source venv/bin/activate
$ pip install -r requirements.txt
$ python manage.py migrate
Windows:
> yarn install
> pip install virtualenv
> virtualenv venv
> .\venv\Scripts\activate
> pip install -r requirements.txt
> python manage.py migrate
- Backend server
$ python manage.py runserver
From another terminal window in the same directory:
- Frontend
$ yarn serve
The Vue application will be served from localhost:8080
and the Django API
and static files will be served from localhost:8000
.
API is available at localhost:8080
The dual dev server setup allows you to take advantage of
webpack's development server with hot module replacement.
Proxy config in vue.config.js
is used to route the requests
back to django's API on port 8000.
If you would rather run a single dev server, you can run Django's
development server only on :8000
, but you have to build build the Vue app first
and the page will not reload on changes.
$ yarn build
$ python manage.py runserver
Out of the box, Django will serve the application entry point (index.html
+ bundled assets) at /
,
data at /api/
, and static files at /static/
. Django admin panel is also available at /admin/
and can be extended as needed.
The application templates from Vue CLI create
and Django createproject
are kept as close as possible to their
original state, except where a different configuration is needed for better integration of the two frameworks.
- Django
- Django REST framework
- Django Whitenoise, CDN Ready
- Vue CLI 3
- Vue Router
- Vuex
- Gunicorn
- Configuration for Heroku Deployment
Location | Content |
---|---|
/backend |
Django Project & Backend Config |
/backend/api |
Django App (/api ) |
/src |
Vue App . |
/src/main.js |
JS Application Entry Point |
/public/index.html |
Html Application Entry Point (/ ) |
/public/static |
Static Assets |
/dist/ |
Bundled Assets Output (generated at yarn build ) |
- Set
ALLOWED_HOSTS
onbackend.settings.prod
$ heroku apps:create django-vue-template-demo
$ heroku git:remote --app django-vue-template-demo
$ heroku buildpacks:add --index 1 heroku/nodejs
$ heroku buildpacks:add --index 2 heroku/python
$ heroku addons:create heroku-postgresql:hobby-dev
$ heroku config:set DJANGO_SETTINGS_MODULE=backend.settings.prod
$ heroku config:set DJANGO_SECRET_KEY='...(your django SECRET_KEY value)...'
$ git push heroku
Heroku's nodejs buildpack will handle install for all the dependencies from the package.json
file.
It will then trigger the postinstall
command which calls yarn build
.
This will create the bundled dist
folder which will be served by whitenoise.
The python buildpack will detect the Pipfile
and install all the python dependencies.
The Procfile
will run Django migrations and then launch Django'S app using gunicorn, as recommended by heroku.
See settings.dev
and vue.config.js
for notes on static assets strategy.
This template implements the approach suggested by Whitenoise Django. For more details see WhiteNoise Documentation
It uses Django Whitenoise to serve all static files and Vue bundled files at /static/
.
While it might seem inefficient, the issue is immediately solved by adding a CDN
with Cloudfront or similar.
Use vue.config.js
> baseUrl
option to set point all your assets to the CDN,
and then set your CDN's origin back to your domains /static
url.
Whitenoise will serve static files to your CDN once, but then those assets are cached and served directly by the CDN.
This allows for an extremely simple setup without the need for a separate static server.