Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

🚀 🚀 🚀 River Admin is a very modern and a shiny customizable admin extension with user friendly and easy to use interfaces for django-river_ . The power of it comes from the libraries it uses on both backend and frontend sides which are django-river, django-rest-framework Vue and Vuetify.

.. _River Admin Website: https://riveradminproject.com/ .. _Browser Support: https://vuetifyjs.com/en/getting-started/browser-support#browser-support .. _Vuetify: https://vuetifyjs.com/en/ .. _django-river: https://github.com/javrasya/django-river

|Images|

Donations

This is a fully open source project and it can be better with your donations.

If you are using River Admin to create a commercial product, please consider becoming our sponsor_ , patron_ or donate over PayPal_

.. _patron: https://www.patreon.com/javrasya .. _PayPal: https://paypal.me/ceahmetdal .. _sponsor: https://github.com/sponsors/javrasya

Live Demo

http://demo.riveradminproject.com/river-admin/

User: demo
Password: demo

To run demo locally;

.. code:: bash

    export LOCAL_DEMO=True
    pip install -r requirements.txt
    python manage.py migrate
    python manage.py bootstrap_shipping_example
    python manage.py bootstrap_issue_tracker_example
    python manage.py bootstrap_river_admin_demo
    python manage.py runserver

And then go to http://127.0.0.1:8000/river-admin/

Note: Create an admin user for yourself if you would like more access.

Documentation

Online documentation is available at http://river-admin.rtfd.org/.

Getting Started

Requirements

django-river_ >= 3.2.0
Any Python version that is supported by django-river_
Any Django version that is supported by django-river_
Any browser that is supported by Vuetify_ (Browser Support_)

.. _Browser Support: https://vuetifyjs.com/en/getting-started/browser-support#browser-support .. _Vuetify: https://vuetifyjs.com/en/ .. _django-river: https://github.com/javrasya/django-river

Installation

Note: Before you can set up your workflow, your app integration with django-river must be done. Don't worry it pretty trivial to set it up. To see how to do it with django-river please have a look at django-river_

Install and enable it

.. code:: bash

pip install river-admin

.. code:: python

# settings.py

INSTALLED_APPS=[
    ...
    'river',
    'rest_framework.authtoken',
    'river_admin'
    ...
]

REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': [
        'rest_framework.authentication.BasicAuthentication',
        'rest_framework.authentication.TokenAuthentication',
    ],
    'EXCEPTION_HANDLER': 'river_admin.views.exception_handler'
}

Do migration;

.. code:: bash
```
 python manage.py migrate
```

.. code:: python

 urlpatterns = [
     url(r'^', include("river_admin.urls")),
 ]

Collect statics and make sure STATIC_URL is /static/ (FOR PRODUCTION WHERE DEBUG=False);

.. code:: bash
```
python manage.py collectstatic --no-input --no-post-process
```

Run your application;

.. code:: bash

python manage.py runserver 0.0.0.0:8000

Open it up on the browser and login with an admin user and enjoy the best way of flowing your work ever :-)

.. code:: bash
```
http://0.0.0.0:8000/river-admin/
```

Out of the Box Examples

River Admin comes with few examples that you can fiddle with and find your way easier.

Note: Enabling them will create their tables and also the necessary workflow components in the DB for you. It might be good idea to try them out on a development database.

Shipping Flow ^^^^^^^^^^^^^

Enable the example app and then run your application

.. code:: python

   # settings.py

   INSTALLED_APPS=[
       ...
       'river',
       'rest_framework.authtoken',
       'river_admin',
       'examples.shipping_example',
       ...
   ]

.. code:: bash

    python manage.py migrate
    python manage.py bootstrap_shipping_example

|Shipping Workflow Img|

Issue Tracking Flow ^^^^^^^^^^^^^^^^^^^

Enable the example app and then run your application

.. code:: python

   # settings.py

   INSTALLED_APPS=[
       ...
       'river',
       'rest_framework.authtoken',
       'river_admin',
       'examples.issue_tracker_example',
       ...
   ]

.. code:: bash

    python manage.py migrate
    python manage.py bootstrap_issue_tracker_example

|Issue Tracking Workflow Img|

Contribute

In order to contribute, fork the repository, look at every instructions in CONTRIBUTE_ before you work then commit your changes and send a pull request.

Make sure you add yourself to CONTRIBUTORS_.

.. _CONTRIBUTE: https://github.com/javrasya/river-admin/blob/master/docs/contribute.rst .. _CONTRIBUTORS: https://github.com/javrasya/river-admin/blob/master/CONTRIBUTORS

.. _license:

License

This software is licensed under the New BSD License. See the LICENSE FILE_ file in the top distribution directory for the full license text.

.. _LICENSE FILE: https://github.com/javrasya/river-admin/blob/master/LICENSE

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].

Stars: ✭ 55

Visit Git Page 🔗Visit User Page 🔗Visit Issues Page (4) 🔗