Skip to content
/ djangox Public template
forked from wsvincent/lithium

Django starter project with 🔋

License

Notifications You must be signed in to change notification settings

smitht06/djangox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DjangoX

A framework for launching new Django projects quickly. Comes with a complete user authentication flow, custom user model, and social authentication options via Gmail, Facebook, Twitter, etc.

NOTE: This open source project is supported by my two published books Django for Beginners and REST APIs with Django. Learn how to build, test, and deploy websites with Django.

Features

  • For Django 2.1 and Python 3.7
  • Modern virtual environments with pipenv
  • Styling with Bootstrap v4.1.3
  • Custom user model
  • Email/password for log in/sign up instead of Django's default username/email/password pattern
  • Social authentication via django-allauth
  • django-debug-toolbar

First-time setup

  1. Make sure Python 3.7x and Pipenv are already installed. See here for help.
  2. Clone the repo and configure the virtualenv:
$ git clone https://github.com/wsvincent/djangox.git
$ cd djangox
$ pipenv install
$ pipenv shell
  1. Set up the initial migration for our custom user models in users and build the database.
(djangox) $ python manage.py makemigrations users
(djangox) $ python manage.py migrate
  1. Create a superuser:
(djangox) $ python manage.py createsuperuser
  1. Confirm everything is working:
(djangox) $ python manage.py runserver

Load the site at http://127.0.0.1:8000.

Home

Sign up

Next Steps

Adding Social Authentication

Learn More

Want to build DjangoX from scratch and understand how it all really works? Check out my book-length look at Django which overs how to build five progresively more complex web applications in Django, starting with a "Hello, World" app and concluding with a robust Newspaper app with complete user authentication flow, custom user model, foreign keys, and more.

The first 4 chapters are available for free online at https://djangoforbeginners.com/.

Django for Beginners

About

Django starter project with 🔋

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 58.1%
  • HTML 36.5%
  • CSS 2.7%
  • Dockerfile 2.7%