feat: optionally allow the primary sections of the project sidebar be collapsible

[SeanCassiere]

Description

From the Table channel: https://discord.com/channels/719702312431386674/1266888851260182548

This change makes the sections in the sidebar of the documentation portion of the website collapsible, by project-specific configuration in their docs/config.json file.

Configuration

If you want to make a section collapsible, you'll need to add collapsible: true to the overarching section in the individual Project's docs/config.json. Furthermore, you can optionally choose to have the sidebar section be in its 'collapsed' by default, using the defaultCollapsed property by setting it to true.

Note

If the collapsible property resolves to false | undefined, then any value set on the defaultCollapsed property will be disregarded and have no effect on the rendered content.

E.g.

{
    "$schema": "https://raw.githubusercontent.com/TanStack/tanstack.com/main/tanstack-docs-config.schema.json",
    "docSearch": {},
    "sections": [
        {
            "label": "Getting Started",
            "children": [],
            "frameworks": []
        },
        {
            "label": "Guide",
            "children": [],
            "collapsible": true, // <-- makes the entire section collapsible
            "defaultCollapsed": false // <-- controls whether the section is 'closed' on render, by default it is false
            "frameworks": []
        }
    ]
}

Screenshots

Before:

After:

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
tanstack-com	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Aug 17, 2024 10:23am

[KevinVandy]

I think this great. Maybe add a defaultCollapsed boolean too?

[SeanCassiere]

@KevinVandy changes have been made 🎉

Edit: I'd give it a test locally to make sure this is the kind of UX you are looking for Table.