Node.js web app framework with file-based routing, templating, sessions, and markdown support out of the box. https://www.npmjs.com/package/@awmottaz/grackle
  • JavaScript 100%
Find a file
2026-04-16 12:51:52 -05:00
.vscode prettier setup for markdown files 2026-03-31 16:03:32 -05:00
docs support custom postprocessing rules for static files 2026-04-16 12:48:23 -05:00
examples/basic-example support custom postprocessing rules for static files 2026-04-16 12:48:23 -05:00
lib support custom postprocessing rules for static files 2026-04-16 12:48:23 -05:00
tests [breaking] simplify file naming API, templating, and postprocessing 2026-04-14 10:48:56 -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
.prettierrc update docs 2026-04-15 11:00:03 -05:00
biome.json upgrade biome 2026-04-14 10:43:35 -05:00
grackle-cli.js support custom postprocessing rules for static files 2026-04-16 12:48:23 -05:00
grackle-server.js support custom postprocessing rules for static files 2026-04-16 12:48:23 -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 2.1.0 2026-04-16 12:51:52 -05:00
package.json 2.1.0 2026-04-16 12:51:52 -05:00
README.md update readme 2026-04-15 10:06:22 -05:00
types.d.ts support custom postprocessing rules for static files 2026-04-16 12:48:23 -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 npx grackle server. Then you can make a request:

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

Complete documentation is bundled with your installation of Grackle, and can also be found in the docs folder. To view the bundled documentation, run npx grackle docs.

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.