Mojolicious for Node.js. This project is still experimental and
not quite ready for production use yet (but soon!). If you want to stay up to date on the latest developments join us
on IRC (#mojo.js
on Libera.Chat).
Features
- 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.
Installation
All you need is a recent Node.js release.
$ npm install -g @mojojs/mojo
Getting Started
These four lines are a whole web application.
import mojo from '@mojojs/mojo';
const app = mojo();
app.get('/', ctx => ctx.render({text: 'I ♥ Mojo!'}));
app.start();
Use the built-in command system to start your web server.
$ node index.mjs server
[77264] Web application available at http://127.0.0.1:3000/
Test it with any HTTP client you prefer.
$ curl http://127.0.0.1:3000/
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/mojo';
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();
ws.send(title);
}
});
});
app.start();
const inlineTemplate = `
<script>
const ws = new WebSocket('<%= ctx.urlFor('title') %>');
ws.onmessage = event => { document.body.innerHTML += event.data };
ws.onopen = event => { ws.send('https://mojolicious.org') };
</script>
`;
Want to know more?
Take a look at our documentation!