iPULSY — Project Overview & Design Reference

Design system

Tokens and patterns from DESIGN-SHOWCASE.md and globals.css. Live reference: ipulsy.com

Token	Value (dark)	Usage
`--color-rose-500`	#f43f5e	Brand, accent, chart-1, link-standalone
`--bg-primary`	#0f0f12	Page base
`--bg-secondary`	#1d1d23	Content sections
`--bg-mid`	#18181d	Alternating sections, cards, gradients
`--bg-card`	`var(--bg-mid)`	Cards (same as mid)
`--text-primary`	#fafaf9	Headings
`--text-secondary`	#f4f4f5	Body text
`--text-muted`	#b8b8c2	Labels, hints
`--text-hero`	#FFEEDD	Hero title
`--border-color`	`color-mix(in srgb, var(--text-secondary) 20%, transparent)` (zinc-100/20)	Borders
`--bg-card-alt`	`var(--bg-secondary)`	Card alt, showcase striping (app uses Tailwind for table chrome)
`--color-yellow-500` … `--color-blue-500`	McBile ramp (see DESIGN-SHOWCASE)	Accents, gradients, stats

Fonts: Montserrat (body, headings), JetBrains Mono (stats, code), Audiowide (PULSY), Slackey (brand "i"). Typography: .page-title-hero 40/50/60px, section title text-3xl md:text-4xl font-extrabold, subtitle text-xl. Containers: max-w-3xl (hero, legal), max-w-4xl (content), max-w-7xl (showcase). Breakpoint sm: 40.6rem.

◇ Gradients & classes

.gradient-pulse-red-br — CTA, showcase brand chip, chatbot strip: linear to bottom right (var(--color-pulse-500) → var(--color-red-500))
.gradient-text — accent text
.link-standalone — rose-400, no underline
.tab-active — border-bottom rose-500

◇ Stat colors

.stat-1 / .stat-pink — rose-500
.stat-2 / .stat-green — blue-500
.stat-3 / .stat-orange — yellow-500

◇ Components

Card, CardGrid, Button, Tabs, Table
Book Demo / Contact Us modals
BrandName, Logo, IpulsyIcon
Header, Footer, ThemeSwitcher, LanguageSwitcher

Tech stack

Next.js marketing site — App Router, React 19, TypeScript 5, Tailwind CSS 4

Layer	Technology	Version / purpose
Framework	Next.js	16.2.1 — App Router, SSR, i18n [locale]
UI	React	19.2.4 — Server & Client Components
Language	TypeScript	5 — type safety
Styling	Tailwind CSS	4.2.1 — design system, light/dark
Charts	Recharts	3.7.0 — Showcase dashboards
UI primitives	Radix UI	1.4.3 — accessible
Icons	Lucide React	0.576+
Utilities	clsx, tailwind-merge, cva	Class merging, variants
Email	Resend	Contact Us, Book Demo
Cache	Upstash Redis	Bounce alerts, digest
Analytics	Microsoft Clarity	Session recording, heatmaps (cookie consent)
Analytics	GA4	Web analytics, events, traffic (MCP integration)
Deploy	Vercel	Hosting, edge functions
Tests	Vitest	4.0.18 — unit/integration, 356 tests (69 test files under `src/` and `tests/`)
Tests	Playwright	1.58.2 — E2E (critical-paths, mission-carousel)
Build	PostCSS	8.5.8 — Tailwind pipeline
Lint	ESLint	9.36.0 — eslint-config-next
Media	FFmpeg, ImageMagick, Pillow, Gifski	Platform/media tools (icons in public/svg/tools/)

Pages (under [locale])

Routes prefixed by locale: /en, /ru. Sitemap.xml: one URL per path per locale.

Route	File	Description
`/[locale]`	page.tsx	Home — hero carousel, features, metrics, CTA
`/mission`	mission/page.tsx	Mission — principles, Who we are card
`/products`	products/page.tsx	Products — iPULSY, McBile family
`/pipeline`	pipeline/page.tsx	Pipeline
`/showcase`	showcase/page.tsx	Showcase — 8 demo dashboards
`/kpi-report`	kpi-report/page.tsx	KPI report — tabbed demo tables
`/datadive`	datadive/page.tsx	Data Dive — metric areas
`/platform`	platform/page.tsx	Platform — lifecycle, Data Flow, Chat, MCPs
`/tech-stack`	tech-stack/page.tsx	Tech stack
`/sitemap`	sitemap/page.tsx	User-facing sitemap (footer Resources)
`/privacy`	privacy/page.tsx	Privacy policy
`/terms`	terms/page.tsx	Terms of use
`/cookies`	cookies/page.tsx	Cookie policy

Components

Layout, UI, Analytics — src/components/

⊞ Layout

header.tsx — Sticky header, nav, mobile menu, Book Demo
footer.tsx — Footer, links, theme, Book Demo
theme-switcher.tsx — Light/dark
language-switcher.tsx — EN/RU

◇ UI

button.tsx, card.tsx, card-grid.tsx
logo.tsx, ipulsy-icon.tsx, brand-name.tsx
table.tsx, tabs.tsx
book-demo-modal.tsx, contact-us-modal.tsx

◇ Analytics

analytics-provider.tsx — Cookie consent, Clarity toggle
clarity.tsx — MS Clarity session recording
cookie-consent.tsx — Banner, Accept/Reject

Data & content flow

Static site — dictionaries and API routes

CONTENT
src/lib/dictionaries/en.json, ru.json — i18n

▼

App Router
getDictionary(locale), generateMetadata, Server Components

▼

API
POST /api/contact, POST /api/book-demo — Resend; /api/webhooks/resend — bounce; /api/cron/email-digest — Upstash Redis

Scripts (package.json)

Development, build, test, quality

Script	Command	Purpose
dev	next dev	Development server
build	next build	Production build
start	next start	Production server
lint	eslint	Linter
test	vitest	Unit/integration (watch)
test:run	vitest run	Tests once
test:coverage	vitest run --coverage	Coverage report
test:e2e	playwright test	E2E tests
knip	knip	Dead code
depcheck	depcheck	Unused deps
ts-prune	ts-prune	Unused TypeScript symbols

Visionary — agents & commands

8 agents, 10 commands — .cursor/visionary/

Agents (8)

orchestrator-fe — Frontend workflow
planner — Implementation planning
designer, copywriter — UI and copy
reviewer-code-fe, resolver-build-error
cleaner-refactor, updater-doc

Commands (10)

/backlog, /project-audit, /commit
/fe-orchestrate, /plan, /fe-code-review
/build-fix, /fe-refactor-clean, /update-docs, /learn

Rules & skills

critical.md visionary-commands.mdc agents.mdc patterns-fe coding-standards-fe casino-metrics-web

Documentation

docs/ — DESIGN-SHOWCASE, Map, DEVELOPER, TECH-STACK, SITEMAP, DICT-CODE-VERIFICATION, etc.

Design & reference

DESIGN-SHOWCASE.md — colors, fonts, components, gradients
Map.md — structure, pages
DEVELOPER.md, TECH-STACK.md, CLIENT-FACING.md

Content & locale

SITEMAP.md, SITEMAP_RU.md
EN-SOURCE-OF-TRUTH.md, DICT-CODE-VERIFICATION.md
OLD-DICTIONARY.md, SITE-JSON-MD-VERIFICATION.md

Root

BACKLOG.md, CHANGELOG.md, RELEASES.md
README.md, VERSION
.cursor/design-system.md — full design reference

Current focus (BACKLOG)

Building marketing website with core pages and responsive design

High priority

Empty — W1 and W2 are deferred (see root BACKLOG.md section Deferred)

Medium & testing

W5 — Testimonials section
W8 — Mobile testing
W9 — Copy improvement
W17 — Example reports with insights (cohort, partners, player)
W18 — Example chat with MCBILE-AI
W21 — MCP integrations scheme
Testing — 356 Vitest tests; coverage thresholds in vitest.config.ts (run npm run test:coverage)

Release history

Key milestones (RELEASES.md)

0.21.22026-04-04

Showcase finance and VIP KPI tables, tooltips, period controls; KPI report page; KPI demo model libraries; SVG and McBile branding refresh; dictionaries and sitemap.

0.202026-03-17

Home restructure (hero-client, home-why-and-after); stage removed; legal-aurora-layout; BrandName no-break. Hero description split by viewport (wide/narrow).

0.192026-03-16

Docs flat layout; HowItWorks rewrite; 319 tests; OG images; tool/MCP SVGs; stage page; Playwright E2E.

0.182026-03-13

Showcase overhaul: stat cards, MetricTooltip, DashboardInsight, per-dashboard period, Traffic FTD metrics. Showcase dark theme; Mission: iPULSY built by MCBILE; product names bold; McBile diagram theme.

0.172026-03-10

Package rename to ipulsy; dead code cleanup (~1500 lines); CardGrid, pipeline refactor. Hero tagline: iGaming Pulse; brand iPULSY elsewhere.

0.162026-03-10

Client confirmation emails (Contact Us, Book a Demo); Subject dropdown; Resend webhook + Vercel Cron; success toasts.

0.152026-03-10

Book a Demo API and form; POST /api/book-demo; commit command agent-only flow.

0.142026-03-10

SVG reorganization (public/svg/); header redesign with dice-style burger, mobile grid nav; Footer, DataDive; Platform and pipeline improvements.

0.132026-03-05

Pulse logo and iPULSY pulse-animated logos; Mission page redesign; pipeline and platform; hero carousel; globals.css. Logo and build fixes.

0.122026-03-04

Logo refresh: iPULSY light/dark and animated SVGs; Header logo Next Image; Pipeline, Footer, hero, platform updates.

0.112026-02-26

Products overhaul: McBile diagram in hero, "Our Products", product cards. Footer, Legal column, Contact/Book Demo modals, Next.js 16, CI.

0.102026-02-26

New home hero: slide carousel and MCP diagram; Show and Sitemap pages; MCP merged with Platform; EN and RU.

0.92026-02-18

iPULSY brand: BrandName component, wordmark and logos; header and footer aligned. Mission carousel, Book a Demo modal, Platform lifecycle.

0.82026-02-14

Burger menu: language and theme in one row; Why iPULSY block; About intro and sections. Wordmark, footer McBile logo.

0.72026-02-14

Why Pulse cards; AI-Driven 360° block (NGR, LTV, Churn, ROI, CAC); modal text; Products spacing; About and dictionary updates.

0.62026-02-13

German (DE): full site localization, B2B Sie. Language switcher EN, RU, DE.

0.52026-02-13

About restructure and full Russian docs; language switcher dropdown; terminology view/insight. Book a Demo modal localized.

0.42026-02-13

Russian and i18n: /en and /ru routes, language switcher; home, About, Features, footer localized. Privacy, Terms, Cookies in English.

0.32026-02-12

Microsoft Clarity analytics; GDPR cookie consent banner. Commit workflow and logo asset migration.

0.22026-02-11

Visionary framework: frontend agents and commands, orchestrator-fe, critical rules, release and changelog workflow.

0.12026-02-04

Initial release: Home, Demo, Metrics, Features, Integrations; McBile Design System; Next.js 16, React 19, Tailwind CSS 4.

i⁠PULSY