In-page examples that don't use (slow) embedded StackBlitz #6013
-
Every example on TanStack Table's docs uses an embedded StackBlitz code sandbox. While it's cool that code is directly editable, I would like to argue that it's far more useful to have the alternative of non-editable but faster examples. In my opinion, examples != playground. The former is to get an understanding of what the library is capable of, what the options can do, and quickly see various ways to use it. The latter is to actually play around with it in a working environment. Currently, TanStack Table docs merges these two. On my PC, booting WebContainers takes about 8 seconds, followed by 15 for installing dependencies, and another 7 for the little embedded browser to load the page. And there's no caching so every example takes this long to load. I think this is unacceptably slow for the purpose of browsing examples! The poll at #4849 also agrees. My suggestion is for examples to be uneditable, hardcoded renders on the page itself, similar to how component libraries do it. For the purposes of playing around, maybe there can be one separate "sandbox" page with an embedded StackBlitz like it is now? Any thoughts? |
Beta Was this translation helpful? Give feedback.
Replies: 1 comment
-
That's what the new code explorer tab is for |
Beta Was this translation helpful? Give feedback.
That's what the new code explorer tab is for