Skip to content

Web/API Gateway with user profiles, billing, and subscription-based access control


Notifications You must be signed in to change notification settings


Repository files navigation

DjaoDjin subscriber session proxy

Documentation Status

DjaoApp brings fully-featured profile, billing and role-based access control pages so you can start building your SaaS product faster. To learn more visit DjaoDjin's Website or browse the project documentation on Read-the-Docs.

DjaoApp is built on Django, Vue.js, Bootstrap frameworks and many more Open Source projects. Thank you for the support!

If you are looking to update the client front-end, you can browse through the API documentation and theme templates documentation.

If you are looking to add features, this project integrates

Tested with

  • Python: 3.10, Django: 3.2 (LTS)


First you will need to create a workspace environment, download the 3rd party vendor prerequisite packages and build the static assets.

DjaoApp transitively depends on multiple native libraries that could or could not be straightforward to install on your Operating System. If you have trouble with the pip install -r requirements-native.txt command, take a look at installation quirks in the documentation.

    $ python -m venv installTop
    $ source installTop/bin/activate
    $ pip install -r requirements-native.txt
    $ pip install -r requirements.txt
    $ make vendor-assets-prerequisites
    $ make install-conf
    $ make build-assets

At this point, all the 3rd party vendor prerequisite packages (Python and Javascript) have been downloaded and installed in the environment. You now need to add your STRIPE keys to the configuration file (i.e. installTop/etc/djaoapp/credentials).

    $ diff -u installTop/etc/djaoapp/credentials
    # Authentication with payment provider
    -STRIPE_PUB_KEY = ""
    +STRIPE_CLIENT_ID = "your-stripe-client-id"
    +STRIPE_PUB_KEY = "your-stripe-production-public-key"
    +STRIPE_PRIV_KEY = "your-stripe-production-private-key"

    # Authentication with payment provider (test keys)
    +STRIPE_TEST_CLIENT_ID = "your-stripe-client-id"
    +STRIPE_TEST_PUB_KEY = "your-stripe-test-public-key"
    +STRIPE_TEST_PRIV_KEY = "your-stripe-test-private-key"

Then create the database, and start the built-in webserver

$ python migrate --run-syncdb
$ python createsuperuser
$ python runserver


You will want to toggle DEBUG on in the site.conf file.

    $ diff -u installTop/etc/djaoapp/site.conf
    -DEBUG = False
    +DEBUG = True

    # Create the tests databases and load test datasets.
    $ make initdb

    # To generate some sample data, disable emailing of receipts and run:
    $ python load_test_transactions

    # Spins up a dev server that re-compiles the `.css` files
    # on page reload whenever necessary.
    $ python runserver --nostatic

Templates Search Path

When a rules.App exists, templates will be first searched for in templates/project_name, then in templates/project_repo, then the default will be used.

All CSS present in the default templates must be declared which ever base.html is included.

Release Notes

  • Sep 6th 2023 Support on Python2 was officially ended on Jan 1st 2020. As of Sep 6th 2023, we no longer test this project for compatibillity with Py2.7.

See release notes and roadmap.