Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mixxorz/generator-django-kaiju
Yeoman generator for Django that includes a live reloading development server, sass support, Foundation 5 and Heroku integration.
https://github.com/mixxorz/generator-django-kaiju
Last synced: 16 days ago
JSON representation
Yeoman generator for Django that includes a live reloading development server, sass support, Foundation 5 and Heroku integration.
- Host: GitHub
- URL: https://github.com/mixxorz/generator-django-kaiju
- Owner: mixxorz
- License: mit
- Created: 2014-10-23T04:22:04.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2015-02-20T17:20:49.000Z (over 9 years ago)
- Last Synced: 2024-10-10T05:34:48.647Z (about 1 month ago)
- Language: CSS
- Homepage:
- Size: 363 KB
- Stars: 8
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# generator-django-kaiju [](https://travis-ci.org/mixxorz/generator-django-kaiju)
> [Yeoman](http://yeoman.io) generator for Django that includes a live reloading development server, sass support, Foundation 5 and Heroku integration.
## Getting Started
### What does it do?
This generator...
* Scaffolds your Django app with good conventions. (core app, multiple settings, etc.)
* Sets up `sass`
* Sets up live reloading development server via grunt
* Configures a `build` task that minifies and concatenates your css/js/images.
* Sets up Foundation 5
* Sets up Font Awesome
* Sets up project for Heroku hosting (Procfile, post-compile scripts)
### Usage
Install `generator-django-kaiju`:
```
npm install -g generator-django-kaiju
```
Make a new directory, and `cd` into it:
```
mkdir mydjangoproject && cd mydjangoproject
```
Make a new `virtualenv` and activate it (Optional)
```
virtulenv venv
source venv/bin/activate
```
Or if you're using virtualenvwrapper
```
mkvirtualenv myvenv
```
Run `yo django-kaiju`, optionally passing your project's name
```
yo django-kaiju [appname]
```
### Grunt tasks
* `python manage.py gruntserver` - starts the Django development server and the live reloading server.
* `grunt` - compiles sass and runs autoprefixer.
* `grunt build` - concatenates, copies and minifies css/js/images into `core/assets/dist`
### Heroku
A few things need to be setup in your Heroku app
Initialize a git repo
```
git init
```
Add everything and commit
```
git add -A
git commit -m "Initial commit for mydjangoproject"
```
If you don't have one yet, create your app
```
heroku create
```
Set DJANGO_SETTINGS_MODULE to `.settings.prod`
```
heroku config:set DJANGO_SETTINGS_MODULE='.settings.prod'
```
Set DJANGO_SECRET_KEY to a django secret key. (You can generate one [here](http://www.miniwebtool.com/django-secret-key-generator/))
```
heroku config:set DJANGO_SECRET_KEY=''
```
Finally, explicitly set your buildpack to use Heroku's Multi Buildpack
```
heroku config:set BUILDPACK_URL='https://github.com/heroku/heroku-buildpack-multi'
```
You can now push your app to heroku
```
git push heroku master
```
## Changelog
**1.3**
* Added autoprefixer
* Added gruntserver management command
* Updated used `grunt-sass` version
* Set the fallback DJANGO_SETTINGS_MODULE to `.settings.dev` for convenience
**1.2**
* Switched over to using multi buildpacks for faster deployment
**1.1**
* Removed the need for django-admin to be in PATH during scaffolding
**1.0**
* Initial release
## License
MIT