Welcome to Lunatic Documentation

This is the documentation of the Lunatic framework. Here you can find examples of its use, see the available functionality and examine the framework API.

Quick navigation

• Intro
• Hello, World!
• Architecture
• Guide
  • Routing
  • Middlewares
  • App features
  • Templating
• Middleware
  • Body parser
  • Cookie parser
  • CORS
  • Form parser
  • Not found
  • Static file server
• Reference
  • LunaticServer
  • Request
  • Response
  • Router
  • Types

About Lunatic

There are many backend frameworks available, especially for Node.js. The main reason that prompted me to create yet another is for educational purposes. I wanted to learn how backend frameworks work.

Another reason is that at the time the available solutions were either too minimalistic or simply overkill for most projects. I used to write applications using Express.js, but it comes with a number of caveats:

1. It does not have a built-in type system
2. Basic functionality requires the installation of separate packages

Hence, I decided to create a framework that:

1. Has a built-in type system and works well with TypeScript
2. Includes commonly used middlewares
3. Has zero dependencies

Should I use Lunatic?

Well, you certainly can. The framework codebase is well tested, examples are available. However, Lunatic is more of a pet project. It is currently in maintenance-only mode as I write a lot less TypeScript now.

If you are looking for something that is neither too simple nor too complex, I would suggest using Hono. It is modern, fast, and works with any JavaScript runtime (including edge).

You can also use this project for educational purposes by examining the source code or using Lunatic as a reference backend framework implementation.