Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/FabricLabs/maki
:bento: declarative application framework for high-performance cross-platform services
https://github.com/FabricLabs/maki
fabric framework maki microservice service ui web
Last synced: 27 days ago
JSON representation
:bento: declarative application framework for high-performance cross-platform services
- Host: GitHub
- URL: https://github.com/FabricLabs/maki
- Owner: FabricLabs
- License: mit
- Created: 2013-03-09T02:21:32.000Z (almost 12 years ago)
- Default Branch: tatami
- Last Pushed: 2021-01-27T06:32:43.000Z (almost 4 years ago)
- Last Synced: 2024-04-14T08:23:51.066Z (8 months ago)
- Topics: fabric, framework, maki, microservice, service, ui, web
- Language: HTML
- Homepage: https://maki.io
- Size: 27.7 MB
- Stars: 68
- Watchers: 17
- Forks: 33
- Open Issues: 81
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list-microservice - maki - performance cross-platform services (framework)
README
Maki
==============
[](https://travis-ci.org/martindale/maki)
[](https://coveralls.io/r/martindale/maki)
[](https://github.com/martindale/maki/contributors)
[](https://gratipay.com/Fabric-Foundation)
The complete stack for building extensible apps, faster than ever. Hand-roll your application by telling Maki what your application does, and it takes care of the rest – without getting in your way if you want to customize it.
- **Write Once, Deploy Everywhere** Maki enables a standard definition for applications beyond simply web apps. Because of our resource grammar, we can build desktop and native mobile applications directly – all in supplement to your web application. All with the same code.
- **Resource-Derived Infrastructure** REST makes a lot of sense for APIs – we take it one step further and build the entire application around Resources as named channels, serving events and static documents alike. Even Desktop applications built with Maki use the same, familiar API!
- **Robust Plugin Ecosystem** Maki is an extensible framework – and there's already a huge list of plugins to provide common (and some not so common!) functionality to your application with almost zero-configuration. For example, Maki's identity protocol allows us to support both username/password auth and cryptographic identity!
## Quick Start
You'll need [node.js](http://nodejs.org) to build a Maki application. Additionally, [MongoDB](http://mongodb.org) and [Redis](http://redis.org) are the default storage and messaging engines, so you will need to install and configure them to use the defaults, or override them if you'd like to use something different. We'll be changing this in an upcoming release – see #58 for progress!
1. Install Maki: `npm install martindale/maki`
2. Create your app, perhaps in `yourapp.js`:
```javascript
var Maki = require('maki');
var myApp = new Maki();
myApp.define('Widget', {
attributes: {
name: String
}
});
myApp.start();
```
3. Start your app: `node yourapp.js` – by default, accessible at [http://localhost:9200](http://localhost:9200)
## Behaviors
Maki applications allow you to construct pipelines, as follows:
```javascript
// same as above
var Widget = myApp.define('Widget', { attributes: { name: String } });
Widget.pre('create', function(next, done) {
var widget = this;
// do something before creation...
// call next() to continue creation, or done() to complete. Pass done(err) to
// abort the pipeline! Useful for custom validation rules. :)
});
Widget.post('create', function() {
var widget = this;
// do something after creation! This too is a pipeline – the tasks are
// executed in the order they are injected.
});
```
### Methods
All Maki resources expose these five methods, all of which follow the above pipeline:
- **query** to select a list of documents,
- **get** to get a single instance of a document by its identifier (ID),
- **create** to create a new instance of a document,
- **update** to change properties of a document, and
- **destroy** to remove a document.
## Plugins & Modules
Maki aims to be as lightweight as possible while still offering a base stack that implements #1. We've split out as many components as possible, and offer a list of plugins that can be used to add functionality to any Maki-powered app.
### Core Modules
| Name | Version | Build Status | Coverage |
|-------------------|----------|----------------|----------|
| [maki-queue](https://github.com/martindale/maki-queue) | [](https://www.npmjs.org/package/maki-queue) | [](https://travis-ci.org/martindale/maki-queue) | [](https://coveralls.io/r/martindale/maki-queue) |
| [maki-mongoose-hooks](https://github.com/martindale/maki-mongoose-hooks) | [](https://www.npmjs.org/package/maki-mongoose-hooks) | [](https://travis-ci.org/martindale/maki-mongoose-hooks) | [](https://coveralls.io/r/martindale/maki-mongoose-hooks) |
| [maki-service-websockets](https://github.com/martindale/maki-service-websockets) | [](https://www.npmjs.org/package/maki-service-websockets) | [](https://travis-ci.org/martindale/maki-service-websockets) | [](https://coveralls.io/r/martindale/maki-service-websockets) |
| [maki-forms](https://github.com/martindale/maki-forms) | [](https://www.npmjs.org/package/maki-forms) | [](https://travis-ci.org/martindale/maki-forms) | [](https://coveralls.io/r/martindale/maki-forms) |
### Plugins
| Name | Version | Build Status | Coverage |
|-------------------|----------|----------------|----------|
| [maki-sessions](https://github.com/martindale/maki-sessions) | [](https://www.npmjs.org/package/maki-sessions) | [](https://travis-ci.org/martindale/maki-sessions) | [](https://coveralls.io/r/martindale/maki-sessions) |
| [maki-passport-local](https://github.com/martindale/maki-passport-local) | [](https://www.npmjs.org/package/maki-passport-local) | [](https://travis-ci.org/martindale/maki-passport-local) | [](https://coveralls.io/r/martindale/maki-passport-local) |
| [maki-passport-github](https://github.com/martindale/maki-passport-github) | [](https://www.npmjs.org/package/maki-passport-github) | [](https://travis-ci.org/martindale/maki-passport-github) | [](https://coveralls.io/r/martindale/maki-passport-github) |
| [maki-passport-soundcloud](https://github.com/martindale/maki-passport-soundcloud) | [](https://www.npmjs.org/package/maki-passport-soundcloud) | [](https://travis-ci.org/martindale/maki-passport-soundcloud) | [](https://coveralls.io/r/martindale/maki-passport-soundcloud) |
| [maki-analytics](https://github.com/martindale/maki-analytics) | [](https://www.npmjs.org/package/maki-analytics) | [](https://travis-ci.org/martindale/maki-analytics) | [](https://coveralls.io/r/martindale/maki-analytics) |
| [maki-forms](https://github.com/martindale/maki-forms) | [](https://www.npmjs.org/package/maki-forms) | [](https://travis-ci.org/martindale/maki-forms) | [](https://coveralls.io/r/martindale/maki-forms) |
| [maki-types-file](https://github.com/martindale/maki-types-file) | [](https://www.npmjs.org/package/maki-types-file) | [](https://travis-ci.org/martindale/maki-types-file) | [](https://coveralls.io/r/martindale/maki-types-file) |
| [maki-assets](https://github.com/martindale/maki-assets) | [](https://www.npmjs.org/package/maki-assets) | [](https://travis-ci.org/martindale/maki-assets) | [](https://coveralls.io/r/martindale/maki-assets) |
| [maki-client](https://github.com/martindale/maki-client) | [](https://www.npmjs.org/package/maki-client) | [](https://travis-ci.org/martindale/maki-client) | [](https://coveralls.io/r/martindale/maki-client) |
| [maki-cms-local](https://github.com/martindale/maki-cms-local) | [](https://www.npmjs.org/package/maki-cms-local) | [](https://travis-ci.org/martindale/maki-cms-local) | [](https://coveralls.io/r/martindale/maki-cms-local) |
## Documentation
For our documentation, see the `docs/` subfolder.
## Contributors
- [@martindale](https://github.com/martindale)
- [@chrisinajar](https://github.com/chrisinajar)
- [@jlukic](https://github.com/jlukic)
- [@unusualbob](https://github.com/unusualbob)
- [@overra](https://github.com/overra)
- [@unChaz](https://github.com/unChaz)
- [@toriborealis](https://github.com/toriborealis)
Special thanks to [the whole Maki community](https://maki.io/people) for supporting this project with their presence and more.
Many, many other contributors deserve recognition for their work on the open source projects that have made Maki possible. See `package.json` for just a few of them.
## Spirit
Please feel free to submit changes to this repo via pull requests! We're trying to keep this as general and flexible as possible, so anyone can take the project and run with it.