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-24 20:05:52 -05:00
.vscode internal: uninstall prettier, update some vscodium settings 2026-04-22 20:30:53 -05:00
docs fix docs layout 2026-04-22 21:44:04 -05:00
examples/basic-example fix example installing from parent package 2026-04-22 21:44:15 -05:00
lib more route naming fixes 2026-04-23 11:50:22 -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
biome.json upgrade biome 2026-04-14 10:43:35 -05:00
grackle-cli.js feat: support loading env files 2026-04-23 11:26:44 -05:00
grackle-server.js handle uncaught errors from handler functions 2026-04-24 10:25:28 -05:00
jsconfig.json support TypeScript handlers 2026-04-17 09:12:01 -05:00
LICENSE license and copyright notices 2026-03-23 15:48:08 -05:00
package-lock.json 3.1.0 2026-04-24 20:05:52 -05:00
package.json 3.1.0 2026-04-24 20:05:52 -05:00
README.md update readme 2026-04-15 10:06:22 -05:00
types.d.ts implement configurable cache-control headers 2026-04-22 21:43:52 -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.