Important
This is a design prototype only. It has no backend, no database, no API, no authentication and no real money data.
Every number, transaction and notification is static mock data in lib/data.ts or comes from the Figma chart export.
Nothing you do in the UI is saved — reload the page and it's back to the original state.
A pixel-perfect, working front-end implementation of the Statsnap "Finance Dashboard — Redesign" Figma frame
(node 1:3, 1440 × 1024), built with Next.js 16 (App Router), shadcn/ui (Base UI) and Tailwind CSS v4.
Only the Reports screen exists. Navigation items for other screens show a short "coming soon" toast.
pnpm installpnpm devOpen http://localhost:3000. The design is authored at 1440 × 1024 — that viewport matches Figma 1:1.
Other scripts: pnpm build · pnpm start · pnpm lint
| Area | Behaviour |
|---|---|
| Sidebar | Collapse/expand (button or ⌘B / Ctrl B). Collapsed, the logo stays and the toggle glides down beneath it. Tooltips on the rail, Planning group expands/collapses, profile menu. Below 1024px it becomes a slide-in drawer |
| Search | Filters the transactions table by name, category or payment method. / focuses it, Esc clears it |
| Date range | Presets + range calendar (two months on desktop, one on phones). Press-and-drag to select, drag either end to adjust, or click start then end. Filters the transactions table and the CSV export |
| Download | Generates a real CSV of the currently filtered transactions — entirely in the browser |
| Cash Flow chart | Hover to scrub any day (crosshair, points and tooltip follow the line), click to pin a week, ←/→ (Shift = week) when focused. Tooltip flips side near the right edge; the active month label highlights |
| Recent transactions | "View all" reveals 11 more mock rows; row hover |
| Help / Notifications | Popovers with keyboard shortcuts and sample notifications ("Clear all" works) |
What it does not do: fetch or persist anything, sign in/out, change the KPI cards or the chart line when the date range changes (the chart is the exact Figma export).
| Width | Layout |
|---|---|
| ≥ 1280px | Figma layout: docked 260px sidebar, 4 KPI cards in a row, floating chart tooltip, 5-column table |
| 1024–1279px | Docked sidebar, KPI cards 2 × 2 |
| 768–1023px | Sidebar becomes a drawer (menu button in the header, scrim, Esc to close); search stays inline |
| < 768px | Search collapses to an icon that expands over the header (with Cancel); Help hidden (it's keyboard shortcuts); Download is icon-only; chart readout docks above the plot and you scrub with your finger (lift to pin); table becomes a stacked list; date picker shows one month with scrollable presets |
The main scroll area reserves its scrollbar gutter (scrollbar-gutter: stable), so expanding "View all" never shifts the layout sideways.
Title Reports · Statsnap (template %s · Statsnap), description, Open Graph + Twitter cards, web manifest and theme colour, all in app/layout.tsx. File-based icons:
app/icon.svg— favicon (the Figma logo mark)app/apple-icon.tsx— 180×180 home-screen iconapp/opengraph-image.tsx/twitter-image.tsx— 1200×630 card: full logo (mark + Geist SemiBold wordmark) on whiteapp/manifest.ts
Pages are marked noindex because this is a prototype.
Social card URLs (lib/site-url.ts): production builds point og:image at https://statsnap-kargul.vercel.app. Vercel previews use their own deployment URL, and next dev uses localhost (link-preview crawlers can't reach localhost, so test previews on a deployed URL). To move to a custom domain, set NEXT_PUBLIC_SITE_URL (see .env.example). Don't rely on VERCEL_PROJECT_PRODUCTION_URL here: on this project it resolves to statsnap-eight.vercel.app, which 404s.
- All icons, the logo, chart gridlines, series lines, crosshair and data points are the original Figma SVG exports in
public/figma/. Icons are tinted through CSS masks so they can follow theme tokens; their geometry is untouched. - Sizes, spacing, radii, shadows and colours are taken from the Figma node values (see
DESIGN_SYSTEM.md). - One deliberate deviation: in Figma the X-axis month labels use a narrower scale than the gridlines and data (the "Sep" label sits ~270 px left of the September gridlines, while the tooltip correctly says Jun 18–24). The labels here are centred on the real month gridlines so hovering lines up with the right month.
- Buttons intentionally don't bounce — no scale/translate on press. Feedback is a 120 ms colour + shadow change.
- Motion follows Emil Kowalski's design-engineering rules: strong custom ease-out curves, nothing over 250 ms, no animation on keyboard-triggered actions, hover effects gated behind
(hover: hover), andprefers-reduced-motionrespected.
app/
globals.css ← the design system: primitives → semantic tokens → shadcn map → Tailwind theme
layout.tsx ← fonts (Geist, Geist Mono, Inter) + providers
page.tsx ← renders <Dashboard />
components/
dashboard/
dashboard.tsx ← page shell + state (sidebar, search, date range, table expansion)
app-sidebar.tsx ← Figma 1:5
page-header.tsx ← Figma 1:125
report-toolbar.tsx ← Figma 1:145 (date range + Download)
kpi-cards.tsx ← Figma 1:159
cash-flow-card.tsx ← Figma 1:213 (interactive chart)
transactions-card.tsx← Figma 1:286
ui/range-calendar.tsx ← drag-to-select range calendar (built on react-day-picker)
icon.tsx ← mask-tinted Figma icon
ui/ ← shadcn/ui components, re-skinned with Statsnap tokens
lib/
data.ts ← ALL mock data
use-media-query.ts ← SSR-safe breakpoint hook
brand-image.tsx ← shared logo/font for generated icons + OG card
chart.ts ← chart geometry + reading the Figma line export for hover
format.ts, prototype.ts, utils.ts
public/figma/ ← Figma SVG exports (do not edit)
DESIGN_SYSTEM.md ← full token + component documentation
- Replace
lib/data.tswith server data (Route Handlers / Server Components). - Render the chart from data (e.g. Recharts via
shadcn add chart) instead of the static SVG — the scales inlib/chart.tsalready describe the axes. - Wire the date range into the KPI and chart queries.
- Add real routes for the sidebar items and real auth for the profile menu.