DEV Community

Cover image for HazelJS v0.2.0 Stable Release
Muhammad Arslan
Muhammad Arslan

Posted on

HazelJS v0.2.0 Stable Release

#webdev #javascript #news #opensource

We’re excited to launch HazelJS v0.2.0 in stable.

In just the last month, the community has already shown up big:

  • 36 GitHub stars
  • 170k+ downloads per month

That momentum matters. It means you’re building, shipping, and asking for the details that make a framework feel predictable when it meets real projects.

What “stable” means here

Stable is our promise that the core developer experience is now consistent and automation-friendly:

  • generator outputs are easier to reason about (and script)
  • workflows are “sharp edges first, escape hatches included”
  • the stack stays modular without turning setup into a scavenger hunt

If you’re coming from beta/alpha, you should feel this immediately when you scaffold and iterate.

AI-native runtime and framework

HazelJS is built for AI applications from the ground up—AI isn’t a plugin you bolt on later, it’s first-class in how you build, compose, and ship.

With the stable v0.2.0 release, the “core” and the “AI” pieces snap together cleanly:

  • @hazeljs/ai — one unified API for LLM providers (streaming, embeddings, function calling)
  • @hazeljs/agent — production-ready agent runtime (think → act → persist, tools, memory, and safe execution)
  • @hazeljs/rag — end-to-end retrieval pipeline (loaders, vector stores, and knowledge-grounded responses)

So you can build AI features using the same patterns you already trust in HazelJS: modules, dependency injection, controllers, and lifecycle hooks.

The headline upgrade: CLI generation, built for automation

HazelJS v0.2.0 makes scaffolding and generation simple, predictable, and automation-ready.

Here are the new “grab-and-go” workflows we’re most excited about:

Start with a quick app skeleton 

hazel g app my-api
cd my-api
npm install
Enter fullscreen mode Exit fullscreen mode

No installs or git init run automatically here—just a clean, repeatable starting point.

Generate anything with setup (any package)

Need a minimal starter file for a package? Now you can:

hazel g setup swagger
# alias: hazel g st swagger

hazel g setup oauth
hazel g setup prisma
Enter fullscreen mode Exit fullscreen mode

This drops a ready-to-edit *.setup.ts file and prints the next step (npm install @hazeljs/<package>).

Discover everything the CLI can generate 

hazel g --list
hazel g --list --list-json
Enter fullscreen mode Exit fullscreen mode

Machine-readable output with --json

When you’re generating in CI, you want output you can parse.

Just add --json:

hazel g controller users --json
hazel g setup swagger --json
Enter fullscreen mode Exit fullscreen mode

The CLI prints a single JSON object describing what was created (or would be created in --dry-run mode).

How to try HazelJS v0.2.0

If you want a minimal starting point:

npm install @hazeljs/core @hazeljs/cli
Enter fullscreen mode Exit fullscreen mode

Then scaffold and go:

hazel g app my-app
cd my-app
npm install
npm run dev
Enter fullscreen mode Exit fullscreen mode

For full docs, jump into:

Docs + NPM backlinks (all packages)

Thanks for pushing us to stable

Stable releases don’t happen in a vacuum—they happen because people try the thing, break it, and tell us what to fix.

Thanks for the 36 stars and the 170k+ downloads. We’re ready for the next wave of real-world use, and we’ll keep improving the DX with the same “ship-first” mindset.

— The HazelJS Team

Top comments (0)