Skip to content
This repository has been archived by the owner on Jun 10, 2023. It is now read-only.
/ django-template Public archive

Simple, extensible, easy to set up, fully functional, django project template.

License

Notifications You must be signed in to change notification settings

nikolak/django-template

Repository files navigation

{% if False %}

Introduction

The goal of this project is to provide minimalistic django project template that everyone can use, which just works out of the box and has the basic setup you can expand on.

Template is written with django 1.11 and python 3 in mind.

Default Home View

Main features

  • Separated dev and production settings

  • Example app with custom user model

  • Bootstrap static files included

  • User registration and logging in as demo

  • Procfile for easy deployments

  • Separated requirements files

  • SQLite by default if no env variable is set

Usage

To use this template to start your own project:

Existing virtualenv

If your project is already in an existing python3 virtualenv first install django by running

$ pip install django

And then run the django-admin.py command to start the new project:

$ django-admin.py startproject \
  --template=https://github.com/nikola-k/django-template/zipball/master \
  --extension=py,md \
  <project_name>

No virtualenv

This assumes that python3 is linked to valid installation of python 3 and that pip is installed and pip3is valid for installing python 3 packages.

Installing inside virtualenv is recommended, however you can start your project without virtualenv too.

If you don't have django installed for python 3 then run:

$ pip3 install django

And then:

$ python3 -m django startproject \
  --template=https://github.com/nikola-k/django-template/zipball/master \
  --extension=py,md \
  <project_name>

After that just install the local dependencies, run migrations, and start the server.

{% endif %}

{{ project_name|title }}

Getting Started

First clone the repository from Github and switch to the new directory:

$ git clone [email protected]/USERNAME/{{ project_name }}.git
$ cd {{ project_name }}

Activate the virtualenv for your project.

Install project dependencies:

$ pip install -r requirements/local.txt

Then simply apply the migrations:

$ python manage.py migrate

You can now run the development server:

$ python manage.py runserver

About

Simple, extensible, easy to set up, fully functional, django project template.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published