The new docs' relative imports make examples tricky to follow

[will-stone]

Hi 👋 🙂

The new docs look fantastic, well done on the roll out. However, I have some feedback that the examples are now a bit harder to follow. Whereas before, the code snippets only used components from react-aria-components, there are now references to local components that we can't see.

For example, here's the Select component referencing the ./Select file:

That's fine, we can follow that into the next example tab, but then this file references a ./ListBox file which we can't see:

It's not until we follow the code in StackBlitz do we find out that we need to be using the ListBoxItem from the library.

Whereas before we could copy paste and be off to a good start, there's now no way to do this.

Thanks,

Will.

[rothsandro]

You can click on the import path './ListBox' to open the file as an additional tab.

[will-stone]

Oh cool. However that only works for the top example:

CleanShot.2025-12-18.at.11.11.47.mp4

[will-stone]

Also the original examples were much easier to grok because you could see all the required RAC components in one block.

[devongovett]

The new examples are more realistic because they show how multiple reusable components are put together (ie how ListBox is shared between Select, ComboBox, etc.). We got feedback that this was not clear on the old site. The new examples are designed to be downloaded or installed with shadcn, and then modified, rather than manually pieced together.

One idea I had was for the copy button to include all of the files as well, with comments to denote where they begin, but you'd have to manually split them up in your editor so idk if this is a good idea.