tools - BevvyTech/BrewskiDocs GitHub Wiki

Tools Overview (/tools)

Purpose

  • Present the catalogue of operational utilities available to authenticated users (ABV calculator, AI galleries, announcement tooling, etc.).
  • Gate super-user features visually while still giving admins quick access to day-to-day tools.

Data & Dependencies

  • Relies on auth context to determine whether the current user is a super user (revealing extra cards) but does not fetch remote data itself.
  • Navigation cards link to the individual tool routes where the actual feature logic lives.

Key Interactions

  • Displays breadcrumb back to dashboard plus introductory copy from i18n translations.
  • Surfaces AWRS/URN Check, ABV calculator, and AI images cards to every user; super users additionally see DO Browser, Background Remover, Announcements, and DB Browser cards.
  • The AWRS/URN Check tile opens AwrsUrnCheckDialog (Admin/src/components/tools/awrs-urn-check-dialog.tsx) via the /tools/awrs-urn route, prompting for a registration number and launching the HMRC search in a popup window.
  • The Background Remover tile calls openBackgroundRemoverPopup and keeps BackgroundRemoverDialog (Admin/src/components/tools/background-remover-dialog.tsx) available so operators can relaunch the Adobe Express window if it is blocked.
  • Each remaining card is a CardActionArea that routes directly into its respective tool page.
  • The Tools navigation section nests DO Browser, Background Remover, AI Search Debug, and DB Browser under a dedicated System subcategory that only surfaces for super users.
⚠️ **GitHub.com Fallback** ⚠️