Skip to content
Switch branches/tags

Mojolicious for Node.js. If you want to stay up to date on the latest developments join us on IRC (#mojo.js on Libera.Chat).


  • An amazing real-time web framework, allowing you to easily grow single file prototypes into well-structured MVC web applications.
    • Everything you need to build cloud-native microservices for state of the art container environments.
    • Powerful out of the box with RESTful routes, WebSockets, HTTP/HTTPS client, plugins, commands, templates, content negotiation, cookies, session management, multipart forms, form and JSON validation, testing framework, HTML/XML parser, static file server, first class Unicode support and much more for you to discover.
    • No default Model. Just use your favorite database. We like PostgreSQL and Knex.js.
    • No default frontend framework. Pair it with React or Vue for a great development experience.
  • Batteries included, yet faster than Express and Koa.
  • Designed for modern JavaScript with async/await, classes and ES modules.
  • Actively maintained by a team with more than 20 years of experience developing mainstream web frameworks such as Mojolicious and Catalyst.


All you need is Node.js 16.0.0 (or newer).

$ npm install @mojojs/core

Getting Started

These four lines are a whole web application.

import mojo from '@mojojs/core';

const app = mojo();

app.get('/', ctx => ctx.render({text: 'I ♥ Mojo!'}));


Use the built-in command system to start your web server.

$ node index.mjs server
[77264] Web application available at

Test it with any HTTP client you prefer.

$ curl
I ♥ Mojo!

Duct tape for the HTML5 web

Use all the latest Node.js and HTML features in convenient single file prototypes like this one, and grow them easily into well-structured Model-View-Controller web applications.

import mojo from '@mojojs/core';

const app = mojo();

app.get('/', async ctx => {
  await ctx.render({inline: inlineTemplate});

app.websocket('/title', ctx => {
  ctx.plain(async ws => {
    for await (const url of ws) {
      const res   = await ctx.client.get(url);
      const html  = await res.html();
      const title = html('title').text();


const inlineTemplate = `
  const ws = new WebSocket('<%= ctx.urlFor('title') %>');
  ws.onmessage = event => { document.body.innerHTML += };
  ws.onopen    = event => { ws.send('') };

Want to know more?

Take a look at our documentation!