WIP (i.e. work in progress), but feel free to get in touh and join us.
We use Django in the backend and React in the frontend. We also use Bower to manage some assets requirements.
That said these are the requirements:
- Python 3.5 with
pip
(virtualenv recommended) - Node.js 5.x with
npm
Once you have pip
and npm
available let's install the dependencies:
pip install -r requirements.txt
npm install
bower install
In order to use Facebook OAuth, create a app as a developer at Facebook and get your app secret and app key.
While setting you app there you should add http://localhost:8000/
http://localhost:8000/app/
and http://localhost:8000/oauth/login/facebook/
as valid OAuth redirect URIs (it's inside Settings, Advanced).
Copy contrib/.env.sample
as .env
in the project's root folder and adjust your settings.
At this point it's crucial to configure the acceess to you database (PostgreSQL is not required, but recommended), and to add the app secret and key you got during the previous step.
Once you're done with requirements, dependencies and settings, create the basic structure at the database and create a super-user for you:
python manage.py migrate
python manage.py createsuperuser
If you are going to run the app with DEBUG=False
first you will have to set the stage for your static files:
python manage.py collectstatic
Not sure? Run python manage.py check
and python manage.py test
just in case.
Run the server with python manage.py runserver
and load localhost:8000 with your favorite browser.
If you want to test the login required area, as a developer you can login through Django Admin and then go back to the root.
Thanks to Golden Roof, ChangHoon, João Proença and Sergey Demushkin for their beautiful icons.
##I License
Licensed under the MIT License.