Settings

Theme

Show HN: Auto-document your analytics setup (npx package)

github.com

17 points by sameenkarim 2 years ago · 5 comments · 1 min read

Reader

Hey HN, sharing an npx package that I’ve been working on to help teams automatically document their analytics setups.

It crawls any JS/TS codebase and generates a YAML schema that catalogs all the events, properties, and triggers. Currently supporting GA, Amplitude, Mixpanel, Amplitude, Rudderstack, mParticle, PostHog, Pendo, Heap, Snowplow. Let me know if there’s any more I should add to the list!

Came out of a personal pain where I was struggling to keep tabs on all the analytics events we had implemented. The “tracking plan” spreadsheets just weren’t cutting it, and I wanted something that would automatically update as the code changed.

Hoping it’ll be helpful to other folks as well. Also open to suggestions for things I can build on top of this! Perhaps a code check tool to detect breaking changes or some UI to view this info when you’re querying your analytics data?

Would love your thoughts and feedback!

wdrevno 2 years ago

Ooo - very nifty tool for anyone who deals with products with complex analytics instrumentations. Tracking plan spreadsheets have just never worked for us.

Love the simplicity of this. Going to give this a go on one of our next projects.

  • sameenkarimOP 2 years ago

    Glad to hear I'm not alone in the frustration! Thanks and let me know how it goes.

andrebrov 2 years ago

Oh, that's great! We have hundreds of events and some of them are from 7-8 years old. At least we can start documenting them now

agentk2049 2 years ago

Wow this seems like a no brainer, glad someone got around to building this!

Keyboard Shortcuts

j
Next item
k
Previous item
o / Enter
Open selected item
?
Show this help
Esc
Close modal / clear selection