JollofJS

The tastiest NodeJS Application Framework you'll ever eat.

Key Features

• Convention over configuration ...Because you have better things to do with your time. But JollofJS is still very configurable.

• Full support for ES7 Async/Await Free yourself from the oppressive/convoluted regime of callbacks and use awesome yieldables/awaitables through ES6 Promises, and Async Await. Powered by KoaJS.

• Built-in Admin User Interface Ever wondered why something like Django Admin doesn't exist for NodeJS? Well with JollofJS, it does now. Administer your site's data with the built-in Jollof Admin (built from scratch using React). E.g You could whip up a blog for your Application and use Jollof Admin as a simple CMS backend for that blog. The options are endless!

• Data Abstraction Done Right JollofJS has a custom-built data abstraction layer that makes it possible to use any database (or REST API) as a datasource so long as an adapter exists for it.

• And More!...

This doc is a Work-in-Progress

Officially Supported DataSources

• MongoDB
• ArangoDB

More to come, and It is very easy to make yours!

Getting Started

npm i -g jollof-cli

You also need to have ArangoDB and Redis up and running.

JollofJS uses Redis for session storage. The scaffolded app will come with the ArangoDB data adapter by default. You can switch to any other compatible datasource anytime by simply making a change in config/ e.g to MongoDB.

Create your JollofJS app with:

jollof new myApp

Before you run your app, create an admin user:

cd myApp
jollof run createAdmin [email protected] password

Now you are ready to run your jollof app:

npm start

You should now be able to see jollof running at http://localhost:3001.

App structure

You are highly advised to study the structure of this new app, starting from index.js.

Jollof Admin

To enter the Jollof admin, you have to login with that admin user you created before launching the app.

Editing an item in the Admin...

The Jollof Admin is, quite frankly, the Saber's edge of any NodeJS framework in existence today. Jollof Admin automatically creates a user interface to administer all your models, as well as in-built models. It supports all the usual field types you find in an other admins, and then some! Including:

• Arrays (Of ANY field type)
• Objects, (Of ANY combination of field types)
• Files,
• GeoLocations

Right now, the app you created has only one used model: User.

See Jollof Docs for how to work with Models.