Node.js web app framework with file-based routing, templating, sessions, and markdown support out of the box.
  • JavaScript 100%
Find a file
2026-03-30 16:48:45 -05:00
.vscode revamp response API, implement request.body.asFormData() 2026-03-25 16:07:01 -05:00
docs add more stuff to the request context and update docs 2026-03-30 16:10:50 -05:00
examples/basic-example add a sample project 2026-03-30 16:34:49 -05:00
lib add more stuff to the request context and update docs 2026-03-30 16:10:50 -05:00
tests fix tests 2026-03-30 16:13:16 -05:00
.gitignore cli: list command implemented 2026-03-16 15:30:44 -05:00
.node-version implement in-memory sessions via cookies 2026-03-26 16:49:21 -05:00
biome.json format with Biome 2026-03-23 21:24:38 -05:00
grackle-cli.js support session DB path 2026-03-28 15:28:34 -05:00
grackle-server.js support session DB path 2026-03-28 15:28:34 -05:00
jsconfig.json format with Biome 2026-03-23 21:24:38 -05:00
LICENSE license and copyright notices 2026-03-23 15:48:08 -05:00
package-lock.json install np for publishing 2026-03-30 16:23:19 -05:00
package.json feedback instructions 2026-03-30 16:48:45 -05:00
README.md feedback instructions 2026-03-30 16:48:45 -05:00
types.d.ts update docs 2026-03-28 15:28:41 -05:00

Grackle

A web server with file-based routing.

Install

npm install @awmottaz/grackle

This installs the grackle CLI app that you can run with npx grackle.

Usage

Here is the smallest Grackle app you can make: create a file at <projectRoot>/routes/+get.js with the following contents:

export default function handle({ response }) {
  response.send(200, "hello, world!");
}

Run your server with NODE_ENV=development npx grackle server. Then you can make a request to your server:

$ curl http://localhost:55401
hello, world!

For many more details, take a look in the docs/ folder. Start with Routing.

Issues, feature requests, and feedback

If you have an omg.lol account, then you have a source.tube account and you can use the issue tracker to submit your feedback.

If you do not have an account, or you just prefer email, then you can send your feedback to grackle@tonymottaz.com.