useCategories

Reactive category list. Sorted by the team's sortOrder, with article counts attached for nav badges.

Usage

HelpNav.tsx

import { useCategories } from '@cstar.help/react';

export function HelpNav() {
  const { categories, isLoading } = useCategories();
  if (isLoading) return null;

  return (
    <ul>
      {categories.map((c) => (
        <li key={c.id}>
          <a href={`/help/c/${c.slug}`}>
            {c.name} <span>({c.article_count})</span>
          </a>
        </li>
      ))}
    </ul>
  );
}

What it returns

categories — array sorted by sortOrder.
Each category has article_count for badge counts.
isLoading, error, refetch as usual.

Next up

useArticles The articles inside each category. useArticleSearch Search across all categories at once.