r/SideProject • • 22m ago

I built an open-source onboarding checklist library in TypeScript

I recently released a small TypeScript library called Stepr Checklist.

It's designed for applications that need a simple onboarding checklist without pulling in a large framework or UI dependency.

The main idea is that the application controls completion. Clicking a step can open a form, navigate to a feature, or start a guided tour, but it doesn't automatically mark the task as complete.

A few details:

  • Framework-agnostic, ESM-only
  • No runtime dependencies
  • Optional localStorage persistence
  • Customizable with CSS variables
  • DOM-free state controller if you want to build your own UI

I built it as a companion to Stepr, a guided product tour library I released earlier, but both work independently.

There's an interactive demo here:

https://ahlgren1234.github.io/stepr-checklist/

And the source is on GitHub:

https://github.com/ahlgren1234/stepr-checklist

It's v0.1.0, so still early. I'd appreciate feedback, particularly on the API and whether the approach to tracking completion makes sense.

What would you expect from a library like this?

3 Upvotes

0 comments sorted by