Skip to content
Javascript framework with Bookshelf, Express, AngularJS and Node
JavaScript HTML CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
migrations
public
.bowerrc
.gitignore
.jshintrc
CHANGELOG.md
LICENSE
README.md
bower.json
gruntfile.js
karma.conf.js
knexfile.js
package.json
process.json
server.js

README.md

BeanJS Logo

BeanJS is a full stack open source framework for using SQL with Node. BeanJS is build on the very powerful Bookshelf.js. Inspired by the superb MeanJS.

MeanJS is a great project and thoroughly recommended, however using a NoSQL solution isn't always the best option which is where this framework comes in.

BeanJS is extremely lightweight and ideal for getting small projects off the ground quickly without all the initial baggage found in other frameworks.

It uses the powerful Knex query builder so you don't to worry about configuring your database schema manually! The Knex migration tools will take care of all this for you through the Yo generator, however at present this is still in development.

Before You Begin

Read about the building blocks for the BeanJS application:

Prerequisites

Make sure you have installed all these prerequisites on your development machine.

  • Node.js - Download & Install Node.js and the npm package manager, if you encounter any problems, you can also use this Github Gist to install Node.js.
  • Postgres / mySQL / any SQL engine - Install your required database engine and configure a database and user account, checkout later how to set it up
  • Bower - You're going to use the Bower Package Manager to manage your front-end packages, in order to install it make sure you've installed Node.js and npm, then install bower globally using npm:
$ npm install -g bower
  • Grunt - You're going to use the Grunt Task Runner to automate your development process, in order to install it make sure you've installed Node.js and npm, then install grunt globally using npm:
$ sudo npm install -g grunt-cli
  • Knex - Install Knex globally in order to make use of the migration scripts for generating your SQL Schema.
$ sudo npm install -g knex

Quick Install

The first thing you should do is install the Node.js dependencies. The boilerplate comes pre-bundled with a package.json file that contains the list of modules you need to start your application, to learn more about the modules installed visit the NPM & Package.json section.

To install Node.js dependencies you're going to use npm again, in the application folder run this in the command-line:

$ npm install

Configure your DB engine

BeanJS is relational database agnostic but there is a couple off steps that needs to be done for your particular Database Engine:

First Edit your config files in /app/config/env (development.js,production.js and test.js needs to be edited).

Finally use Knex to generate the example module.

$ knex migrate:latest

Running Your Application

After the install process is over, you'll be able to run your application using Grunt, just run grunt default task:

$ grunt

Your application should run on the 3000 port so in your browser just go to http://localhost:3000

Contribution

This project is still fairly early in development so we're always looking for contributions!

You can’t perform that action at this time.