Skip to content

feat(frontend): institutions home, search, branded cards, fluid motion - #4

Merged
jattanjie21 merged 4 commits into
mainfrom
feat/frontend-public
May 3, 2026
Merged

jattanjie21 merged 4 commits into
mainfrom
feat/frontend-public

Conversation

@musaajallo

Copy link
Copy Markdown
Collaborator

Summary

  • Reframe the home page around institutions instead of a flat dataset list. / now opens with a centered search bar, then a grid of institution cards (banner + circular logo or initials, sector eyebrow, mandate description, dataset count), with the explanatory band moved underneath.
  • New /institutions/:slug page lists every dataset for a single publisher, with the institution's logo and dataset count in the header.
  • Institution branding everywhere a dataset appears. A reusable InstitutionBadge (logo on white tile, publisher name, green ✓ Verified) sits above the dataset detail title and on every dataset card. The INSTITUTIONS registry lives at src/lib/institutions.ts so future views can reuse it.
  • Dataset detail tabs reordered: Preview is now the default (audience-first); Overview moves to second (developer-oriented schema). Tab content fades + slides in on each switch.
  • Header nav is centered between the GovLink mark and the theme toggle.
  • Polish: site-wide entrance animations (animate-fade-up cascade on grids, fade-up on detail heroes), heavier hover lift on dataset cards, and the CBG logo committed at frontend/public/logos/central-bank-of-the-gambia.png (mirrored from frontend/docs/logos/cbg.png).
  • Docs: root CLAUDE.md orienting future Claude Code sessions on the monorepo split and frontend conventions; frontend/.env.example annotates the Railway backend URL for local + production env wiring.
  • Removed the now-redundant Browse.tsx; /datasets redirects to /.

Test plan

  • npm run typecheck, npm run lint, npm run build clean (verified locally before push).
  • / loads, search filters across datasets, clearing search restores institution grid; cascade animation visible on first paint.
  • Click institution card → /institutions/central-bank-of-the-gambia shows logo header + dataset list.
  • Click dataset card → /datasets/exchange-rates opens on Preview tab; institution chip shows CBG logo + Verified; switching tabs fades in.
  • /about shows the relocated hero + dev strip + existing audience/how-it-works/sources/contact sections.
  • Header nav (Home · API · About) is centered; theme toggle stays right; brand stays left.
  • Vercel preview deploy verifies against the live Railway backend.

🤖 Generated with Claude Code

musaajallo and others added 4 commits May 3, 2026 19:16
- Add a top-level CLAUDE.md that orients on the monorepo split,
  captures the frontend-half conventions (no dedicated CLAUDE.md
  on that side), and points at backend/CLAUDE.md as the source of
  truth for Python work.
- Annotate frontend/.env.example with the live Railway URL so
  contributors can dev against the deployed backend without a
  local API.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Replace the marketing Home with a working surface: search bar
centered at top, institution cards in the middle, intro band
underneath. Each card describes the publishing institution
(sector, mandate, dataset count) with a banner + circular avatar
treatment ported into the existing token system — no shadcn or
framer-motion drag.

- /              → institutions grid (was hero + featured datasets)
- /institutions/:slug → datasets for a single publisher (new)
- /datasets      → redirects to / (Browse.tsx removed)
- /about         → absorbs the old Home hero + dev strip
- Header nav now Home · API · About; breadcrumbs follow suit
- slugify() in lib/utils for publisher → URL-slug round-tripping

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Surface the publishing institution everywhere a dataset appears, and
smooth the page transitions across the site.

Institution branding
- New InstitutionBadge component (logo or initials, name, Verified
  indicator) used on the dataset hero and inside every DatasetCard.
- Logo-aware avatars on InstitutionCard (home grid) and the
  /institutions/:slug header use a white circle so transparent
  publisher logos render cleanly against dark mode.
- INSTITUTIONS registry extracted to src/lib/institutions.ts so any
  view that needs publisher metadata pulls from one place.
- CBG logo committed at frontend/public/logos/central-bank-of-the-gambia.png
  (sourced from frontend/docs/logos/cbg.png) and wired in.

Dataset detail
- Default tab is now Preview (audience-first) with Overview second
  for developers; route order swapped accordingly so /datasets/:slug
  lands on Preview.
- Tab content fades + slides in on each switch via tailwindcss-animate.

Layout & motion
- Header nav is now centered between the brand and the theme toggle.
- Home / Institution grids cascade in with a 50–60ms stagger using
  the existing animate-fade-up keyframe.
- Dataset and dataset-detail heroes fade up on mount.
- Dataset card hover gets a slightly heavier lift and shadow to
  match the institution card.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Drop the warm-paper canvas (#FAF8F4) for pure white (#FFFFFF) and
neutralise the banding tone (--surface-2 #F2EFE8 → #F5F5F5) so the
home, dataset, and footer surfaces still differentiate against the
new white background. Dark mode tokens untouched.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@jattanjie21
jattanjie21 merged commit 6f4211a into main May 3, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants