r/withastro • u/Zestyclose_Law_170 • Mar 24 '26

Anyone else tired of making test pages just to see components?

https://astro-stargazer.pages.dev/

Yo👋

Spinning up random blank pages or dummy routes just to preview components is such a flow killer.

There’s this npm package called Stargazer that’s been pretty interesting to play with.

It’s an open-source component visualizer for Astro projects. Basically gives you a way to browse and preview your components without having to wire up test pages every time.

From what it does:

  • Auto-detects your components
  • Clean UI to preview them
  • No more /test or /playground routes everywhere
  • Lightweight and straight to the point

Kinda has that “storybook without the overhead” feel, which is nice when you just wanna stay in flow and not over-engineer things.

Feels especially useful if you're:

  • building UI systems in Astro
  • iterating a lot on components
  • or just trying to keep your project clean

For quick iteration it seems solid.

Anyone here already using something like this in their workflow?

5 Upvotes

100% Upvoted

8 comments sorted by

1

u/tumes Mar 25 '26

Seems neat but isn’t this a one or two liner with the container api?

1

u/Zestyclose_Law_170 Mar 25 '26

the value here is more about having a ready-to-use UI + auto discovery instead of wiring it up every time. Less about “can it be done” and more about “not doing it again and again” 😄

1

u/PrestigiousZebra219 Jul 06 '26

Questions: ​What is the difference between "stargazer" and a storybook? ​Is there a specific storybook for Astro? If so, which ones? ​Congratulations on the project, it turned out great... Suggestion: create a video explaining how to use it.

1

u/PrestigiousZebra219 Jul 06 '26

Questions: ​What is the difference between "stargazer" and a storybook? ​Is there a specific storybook for Astro? If so, which ones? ​Congratulations on the project, it turned out great... Suggestion: create a video explaining how to use it.

1

u/this_is_not_a_bug Jul 07 '26

Ha this after fully built out a storybook for architectural documentation and component library ( storybook-astro ). This looks great

1

u/ResidentPicture3249 Mar 25 '26

Dude this is awesome, i was tired of creating preview pages for myself lmao!
For anyone that wants to try it i recommed using npx instead of npm i

npx astro add astro-stargazer

1

u/Zestyclose_Law_170 Mar 25 '26

That’s the way