core

ow [pronounced: oouhh] is a node.js framework which enforces certain patterns and restrictions in order to provide you with a stable, testable and modular application architecture.

It's aim is to provide you with a small set of core functions and a diverse set of ow modules which can be added and replaced depending on the needs of your application.

The way you write modules for ow is also straightforward and kept as simple as possible.

If you adhere to ows patterns, you'll end up with applications that are modular, stable and easy to test as well as custom modules which can easily be extracted and reused in different applications.

Quick Start

First, install ow-core in your application. You may use either yarn or npm for this step. ow-core provides both ES and UMD builds, so you can use the one which fits your environment.

yarn add ow-core

Usage

Creating and starting a new app is as simple as writing 3 lines (or 1, if you dare to do so) of code.

import Ow from 'ow-core';

const app = new Ow();

app.start();

yarn start

Okay, that won't do much yet - except logging that your app started - but read on to see how ows module system works.

Adding your first module

To try out ows module system, you may add the ow-hello-world module. It's small, simple and easy to use. So go ahead and follow these steps:

yarn add ow-hello-world

import Ow from 'ow-core';
import HelloWorld from 'ow-hello-world';

const app = new Ow();

app.addModules([
  HelloWorld
]);

app.start();

yarn start

If you're trying this with node.js you should see something like:

Hello World!
Started ow application...
Hello World!