quark.io

quark.io - minimalistic web framework for Node.js

quark.io is the minimalistic web framework for creating small and beautiful HTTP servers.

Main features

• Less dependencies from others packages
• Easy routing
• Jade support
• Static files
• Middleware

Installation

Just do npm install quark.io

Hello World Server

var quark = require('./quark.io');
 
var app = new quark({
    port: 3002
});
 
app.get('/', function(req, res) {
    res.ok('Hello, World!')
});
 
app.start();

Another examples

Another examples look at the examples directory of the repository.

Creating new server

var quark = require('./quark.io');
 
var app = new quark({
    port: 3002, // Listening port, by default 8888
    debug: true, // Debug mode, will produce more output to the logger
    statics: ['public/', 'uploads/'], // Static directories, this array by default empty.
    logger: < Any logger that has similar methods as console >, // By default output goes to the console
    renderTemplate: < Any callback function that acts as 'jade.render' >, // By default used 'jade.render'
    renderFile: < Any callback function that acts as 'jade.renderFile' >, // By default used 'jade.renderFile'
});

Routing

Simple routes:

app.get('/', function(req, res) { ... });
app.post('/user/save', function(req, res) { ... });
app.put('/user/update', function(req, res) { ... });
app.delete('/user/remove', function(req, res) { ... });

Routes with arguments (argument names in route should be equals to the names of the arguments of function):

app.get('/topics/:topicId/message/:message', function(req, res, topicId, message) { ... });
app.post('/user/:userId/send/:message', function(req, res, userId, message) { ... });

Middleware

function middleware(req, res) {
    console.log('Middleware active!');
};
 
function anotherMiddleware(req, res) {
    console.log('Another middleware active!');
};
 
app.get('/', function(req, res) { ... }, middleware, anotherMiddleware);

Requests and responses

Requests and responses are fully compatible with native node.js implementation. But response has some new features:

res.send(data, [code, [headers]]);
res.fail(data, [headers]);
res.ok(data, [headers]);
res.text(data, [headers]);
res.html(data, [headers]);
res.json(data, [headers]);
res.redirect(data, [redirectUrl, [headers]]);
res.render(template, options);
res.renderFile(fileName, options);

Performance

Framework's performance tested with Apache Benchmark (all scripts and results inside benchmark/ directory).

Support

If you do have a contribution for the package feel free to put up a Pull Request or open Issue.