feat: v2.0.0 - Design System Generator with 100 reasoning rules

## Major Features
- Add --design-system flag for AI-powered design recommendations
- 100 industry-specific reasoning rules in ui-reasoning.csv
- Multi-domain parallel search (product, style, color, landing, typography)
- Anti-patterns to avoid for each industry

## New Files
- data/ui-reasoning.csv - 100 UI category rules with style priority, effects, anti-patterns
- scripts/design_system.py - Reasoning engine with BM25 ranking

## Workflow Updates
- All agent workflows updated with new design system generation step
- Step 2 now requires --design-system for comprehensive recommendations
- Updated example workflow with beauty spa case study

## CLI Updates
- Version bumped to 2.0.0
- Added Qoder and Roo Code support
- Synced all agent folders to cli/assets/

## README Updates
- Added version badges and PayPal donation button
- New "What's New in v2.0" section with architecture diagram
- Updated CLI installation instructions

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Viet Tran
2026-01-16 10:46:02 +07:00
parent 1d5659bd77
commit d5fbbfdc9b
136 changed files with 14818 additions and 1843 deletions

View File

@@ -0,0 +1,45 @@
No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
1,Async Waterfall,Defer Await,async await defer branch,React/Next.js,Move await into branches where actually used to avoid blocking unused code paths,Move await operations into branches where they're needed,Await at top of function blocking all branches,"if (skip) return { skipped: true }; const data = await fetch()","const data = await fetch(); if (skip) return { skipped: true }",Critical
2,Async Waterfall,Promise.all Parallel,promise all parallel concurrent,React/Next.js,Execute independent async operations concurrently using Promise.all(),Use Promise.all() for independent operations,Sequential await for independent operations,"const [user, posts] = await Promise.all([fetchUser(), fetchPosts()])","const user = await fetchUser(); const posts = await fetchPosts()",Critical
3,Async Waterfall,Dependency Parallelization,better-all dependency parallel,React/Next.js,Use better-all for operations with partial dependencies to maximize parallelism,Use better-all to start each task at earliest possible moment,Wait for unrelated data before starting dependent fetch,"await all({ user() {}, config() {}, profile() { return fetch((await this.$.user).id) } })","const [user, config] = await Promise.all([...]); const profile = await fetchProfile(user.id)",Critical
4,Async Waterfall,API Route Optimization,api route waterfall promise,React/Next.js,In API routes start independent operations immediately even if not awaited yet,Start promises early and await late,Sequential awaits in API handlers,"const sessionP = auth(); const configP = fetchConfig(); const session = await sessionP","const session = await auth(); const config = await fetchConfig()",Critical
5,Async Waterfall,Suspense Boundaries,suspense streaming boundary,React/Next.js,Use Suspense to show wrapper UI faster while data loads,Wrap async components in Suspense boundaries,Await data blocking entire page render,"<Suspense fallback={<Skeleton />}><DataDisplay /></Suspense>","const data = await fetchData(); return <DataDisplay data={data} />",High
6,Bundle Size,Barrel Imports,barrel import direct path,React/Next.js,Import directly from source files instead of barrel files to avoid loading unused modules,Import directly from source path,Import from barrel/index files,"import Check from 'lucide-react/dist/esm/icons/check'","import { Check } from 'lucide-react'",Critical
7,Bundle Size,Dynamic Imports,dynamic import lazy next,React/Next.js,Use next/dynamic to lazy-load large components not needed on initial render,Use dynamic() for heavy components,Import heavy components at top level,"const Monaco = dynamic(() => import('./monaco'), { ssr: false })","import { MonacoEditor } from './monaco-editor'",Critical
8,Bundle Size,Defer Third Party,analytics defer third-party,React/Next.js,Load analytics and logging after hydration since they don't block interaction,Load non-critical scripts after hydration,Include analytics in main bundle,"const Analytics = dynamic(() => import('@vercel/analytics'), { ssr: false })","import { Analytics } from '@vercel/analytics/react'",Medium
9,Bundle Size,Conditional Loading,conditional module lazy,React/Next.js,Load large data or modules only when a feature is activated,Dynamic import when feature enabled,Import large modules unconditionally,"useEffect(() => { if (enabled) import('./heavy.js') }, [enabled])","import { heavyData } from './heavy.js'",High
10,Bundle Size,Preload Intent,preload hover focus intent,React/Next.js,Preload heavy bundles on hover/focus before they're needed,Preload on user intent signals,Load only on click,"onMouseEnter={() => import('./editor')}","onClick={() => import('./editor')}",Medium
11,Server,React.cache Dedup,react cache deduplicate request,React/Next.js,Use React.cache() for server-side request deduplication within single request,Wrap data fetchers with cache(),Fetch same data multiple times in tree,"export const getUser = cache(async () => await db.user.find())","export async function getUser() { return await db.user.find() }",Medium
12,Server,LRU Cache Cross-Request,lru cache cross request,React/Next.js,Use LRU cache for data shared across sequential requests,Use LRU for cross-request caching,Refetch same data on every request,"const cache = new LRUCache({ max: 1000, ttl: 5*60*1000 })","Always fetch from database",High
13,Server,Minimize Serialization,serialization rsc boundary,React/Next.js,Only pass fields that client actually uses across RSC boundaries,Pass only needed fields to client components,Pass entire objects to client,"<Profile name={user.name} />","<Profile user={user} /> // 50 fields serialized",High
14,Server,Parallel Fetching,parallel fetch component composition,React/Next.js,Restructure components to parallelize data fetching in RSC,Use component composition for parallel fetches,Sequential fetches in parent component,"<Header /><Sidebar /> // both fetch in parallel","const header = await fetchHeader(); return <><div>{header}</div><Sidebar /></>",Critical
15,Server,After Non-blocking,after non-blocking logging,React/Next.js,Use Next.js after() to schedule work after response is sent,Use after() for logging/analytics,Block response for non-critical operations,"after(async () => { await logAction() }); return Response.json(data)","await logAction(); return Response.json(data)",Medium
16,Client,SWR Deduplication,swr dedup cache revalidate,React/Next.js,Use SWR for automatic request deduplication and caching,Use useSWR for client data fetching,Manual fetch in useEffect,"const { data } = useSWR('/api/users', fetcher)","useEffect(() => { fetch('/api/users').then(setUsers) }, [])",Medium-High
17,Client,Event Listener Dedup,event listener deduplicate global,React/Next.js,Share global event listeners across component instances,Use useSWRSubscription for shared listeners,Register listener per component instance,"useSWRSubscription('global-keydown', () => { window.addEventListener... })","useEffect(() => { window.addEventListener('keydown', handler) }, [])",Low
18,Rerender,Defer State Reads,state read callback subscription,React/Next.js,Don't subscribe to state only used in callbacks,Read state on-demand in callbacks,Subscribe to state used only in handlers,"const handleClick = () => { const params = new URLSearchParams(location.search) }","const params = useSearchParams(); const handleClick = () => { params.get('ref') }",Medium
19,Rerender,Memoized Components,memo extract expensive,React/Next.js,Extract expensive work into memoized components for early returns,Extract to memo() components,Compute expensive values before early return,"const UserAvatar = memo(({ user }) => ...); if (loading) return <Skeleton />","const avatar = useMemo(() => compute(user)); if (loading) return <Skeleton />",Medium
20,Rerender,Narrow Dependencies,effect dependency primitive,React/Next.js,Specify primitive dependencies instead of objects in effects,Use primitive values in dependency arrays,Use object references as dependencies,"useEffect(() => { console.log(user.id) }, [user.id])","useEffect(() => { console.log(user.id) }, [user])",Low
21,Rerender,Derived State,derived boolean subscription,React/Next.js,Subscribe to derived booleans instead of continuous values,Use derived boolean state,Subscribe to continuous values,"const isMobile = useMediaQuery('(max-width: 767px)')","const width = useWindowWidth(); const isMobile = width < 768",Medium
22,Rerender,Functional setState,functional setstate callback,React/Next.js,Use functional setState updates for stable callbacks and no stale closures,Use functional form: setState(curr => ...),Reference state directly in setState,"setItems(curr => [...curr, newItem])","setItems([...items, newItem]) // items in deps",Medium
23,Rerender,Lazy State Init,usestate lazy initialization,React/Next.js,Pass function to useState for expensive initial values,Use function form for expensive init,Compute expensive value directly,"useState(() => buildSearchIndex(items))","useState(buildSearchIndex(items)) // runs every render",Medium
24,Rerender,Transitions,starttransition non-urgent,React/Next.js,Mark frequent non-urgent state updates as transitions,Use startTransition for non-urgent updates,Block UI on every state change,"startTransition(() => setScrollY(window.scrollY))","setScrollY(window.scrollY) // blocks on every scroll",Medium
25,Rendering,SVG Animation Wrapper,svg animation wrapper div,React/Next.js,Wrap SVG in div and animate wrapper for hardware acceleration,Animate div wrapper around SVG,Animate SVG element directly,"<div class='animate-spin'><svg>...</svg></div>","<svg class='animate-spin'>...</svg>",Low
26,Rendering,Content Visibility,content-visibility auto,React/Next.js,Apply content-visibility: auto to defer off-screen rendering,Use content-visibility for long lists,Render all list items immediately,".item { content-visibility: auto; contain-intrinsic-size: 0 80px }","Render 1000 items without optimization",High
27,Rendering,Hoist Static JSX,hoist static jsx element,React/Next.js,Extract static JSX outside components to avoid re-creation,Hoist static elements to module scope,Create static elements inside components,"const skeleton = <div class='animate-pulse' />; function C() { return skeleton }","function C() { return <div class='animate-pulse' /> }",Low
28,Rendering,Hydration No Flicker,hydration mismatch flicker,React/Next.js,Use inline script to set client-only data before hydration,Inject sync script for client-only values,Use useEffect causing flash,"<script dangerouslySetInnerHTML={{ __html: 'el.className = localStorage.theme' }} />","useEffect(() => setTheme(localStorage.theme), []) // flickers",Medium
29,Rendering,Conditional Render,conditional render ternary,React/Next.js,Use ternary instead of && when condition can be 0 or NaN,Use explicit ternary for conditionals,Use && with potentially falsy numbers,"{count > 0 ? <Badge>{count}</Badge> : null}","{count && <Badge>{count}</Badge>} // renders '0'",Low
30,Rendering,Activity Component,activity show hide preserve,React/Next.js,Use Activity component to preserve state/DOM for toggled components,Use Activity for expensive toggle components,Unmount/remount on visibility toggle,"<Activity mode={isOpen ? 'visible' : 'hidden'}><Menu /></Activity>","{isOpen && <Menu />} // loses state",Medium
31,JS Perf,Batch DOM CSS,batch dom css reflow,React/Next.js,Group CSS changes via classes or cssText to minimize reflows,Use class toggle or cssText,Change styles one property at a time,"element.classList.add('highlighted')","el.style.width='100px'; el.style.height='200px'",Medium
32,JS Perf,Index Map Lookup,map index lookup find,React/Next.js,Build Map for repeated lookups instead of multiple .find() calls,Build index Map for O(1) lookups,Use .find() in loops,"const byId = new Map(users.map(u => [u.id, u])); byId.get(id)","users.find(u => u.id === order.userId) // O(n) each time",Low-Medium
33,JS Perf,Cache Property Access,cache property loop,React/Next.js,Cache object property lookups in hot paths,Cache values before loops,Access nested properties in loops,"const val = obj.config.settings.value; for (...) process(val)","for (...) process(obj.config.settings.value)",Low-Medium
34,JS Perf,Cache Function Results,memoize cache function,React/Next.js,Use module-level Map to cache repeated function results,Use Map cache for repeated calls,Recompute same values repeatedly,"const cache = new Map(); if (cache.has(x)) return cache.get(x)","slugify(name) // called 100 times same input",Medium
35,JS Perf,Cache Storage API,localstorage cache read,React/Next.js,Cache localStorage/sessionStorage reads in memory,Cache storage reads in Map,Read storage on every call,"if (!cache.has(key)) cache.set(key, localStorage.getItem(key))","localStorage.getItem('theme') // every call",Low-Medium
36,JS Perf,Combine Iterations,combine filter map loop,React/Next.js,Combine multiple filter/map into single loop,Single loop for multiple categorizations,Chain multiple filter() calls,"for (u of users) { if (u.isAdmin) admins.push(u); if (u.isTester) testers.push(u) }","users.filter(admin); users.filter(tester); users.filter(inactive)",Low-Medium
37,JS Perf,Length Check First,length check array compare,React/Next.js,Check array lengths before expensive comparisons,Early return if lengths differ,Always run expensive comparison,"if (a.length !== b.length) return true; // then compare","a.sort().join() !== b.sort().join() // even when lengths differ",Medium-High
38,JS Perf,Early Return,early return exit function,React/Next.js,Return early when result is determined to skip processing,Return immediately on first error,Process all items then check errors,"for (u of users) { if (!u.email) return { error: 'Email required' } }","let hasError; for (...) { if (!email) hasError=true }; if (hasError)...",Low-Medium
39,JS Perf,Hoist RegExp,regexp hoist module,React/Next.js,Don't create RegExp inside render - hoist or memoize,Hoist RegExp to module scope,Create RegExp every render,"const EMAIL_RE = /^[^@]+@[^@]+$/; function validate() { EMAIL_RE.test(x) }","function C() { const re = new RegExp(pattern); re.test(x) }",Low-Medium
40,JS Perf,Loop Min Max,loop min max sort,React/Next.js,Use loop for min/max instead of sort - O(n) vs O(n log n),Single pass loop for min/max,Sort array to find min/max,"let max = arr[0]; for (x of arr) if (x > max) max = x","arr.sort((a,b) => b-a)[0] // O(n log n)",Low
41,JS Perf,Set Map Lookups,set map includes has,React/Next.js,Use Set/Map for O(1) lookups instead of array.includes(),Convert to Set for membership checks,Use .includes() for repeated checks,"const allowed = new Set(['a','b']); allowed.has(id)","const allowed = ['a','b']; allowed.includes(id)",Low-Medium
42,JS Perf,toSorted Immutable,tosorted sort immutable,React/Next.js,Use toSorted() instead of sort() to avoid mutating arrays,Use toSorted() for immutability,Mutate arrays with sort(),"users.toSorted((a,b) => a.name.localeCompare(b.name))","users.sort((a,b) => a.name.localeCompare(b.name)) // mutates",Medium-High
43,Advanced,Event Handler Refs,useeffectevent ref handler,React/Next.js,Store callbacks in refs for stable effect subscriptions,Use useEffectEvent for stable handlers,Re-subscribe on every callback change,"const onEvent = useEffectEvent(handler); useEffect(() => { listen(onEvent) }, [])","useEffect(() => { listen(handler) }, [handler]) // re-subscribes",Low
44,Advanced,useLatest Hook,uselatest ref callback,React/Next.js,Access latest values in callbacks without adding to dependency arrays,Use useLatest for fresh values in stable callbacks,Add callback to effect dependencies,"const cbRef = useLatest(cb); useEffect(() => { setTimeout(() => cbRef.current()) }, [])","useEffect(() => { setTimeout(() => cb()) }, [cb]) // re-runs",Low
1 No Category Issue Keywords Platform Description Do Don't Code Example Good Code Example Bad Severity
2 1 Async Waterfall Defer Await async await defer branch React/Next.js Move await into branches where actually used to avoid blocking unused code paths Move await operations into branches where they're needed Await at top of function blocking all branches if (skip) return { skipped: true }; const data = await fetch() const data = await fetch(); if (skip) return { skipped: true } Critical
3 2 Async Waterfall Promise.all Parallel promise all parallel concurrent React/Next.js Execute independent async operations concurrently using Promise.all() Use Promise.all() for independent operations Sequential await for independent operations const [user, posts] = await Promise.all([fetchUser(), fetchPosts()]) const user = await fetchUser(); const posts = await fetchPosts() Critical
4 3 Async Waterfall Dependency Parallelization better-all dependency parallel React/Next.js Use better-all for operations with partial dependencies to maximize parallelism Use better-all to start each task at earliest possible moment Wait for unrelated data before starting dependent fetch await all({ user() {}, config() {}, profile() { return fetch((await this.$.user).id) } }) const [user, config] = await Promise.all([...]); const profile = await fetchProfile(user.id) Critical
5 4 Async Waterfall API Route Optimization api route waterfall promise React/Next.js In API routes start independent operations immediately even if not awaited yet Start promises early and await late Sequential awaits in API handlers const sessionP = auth(); const configP = fetchConfig(); const session = await sessionP const session = await auth(); const config = await fetchConfig() Critical
6 5 Async Waterfall Suspense Boundaries suspense streaming boundary React/Next.js Use Suspense to show wrapper UI faster while data loads Wrap async components in Suspense boundaries Await data blocking entire page render <Suspense fallback={<Skeleton />}><DataDisplay /></Suspense> const data = await fetchData(); return <DataDisplay data={data} /> High
7 6 Bundle Size Barrel Imports barrel import direct path React/Next.js Import directly from source files instead of barrel files to avoid loading unused modules Import directly from source path Import from barrel/index files import Check from 'lucide-react/dist/esm/icons/check' import { Check } from 'lucide-react' Critical
8 7 Bundle Size Dynamic Imports dynamic import lazy next React/Next.js Use next/dynamic to lazy-load large components not needed on initial render Use dynamic() for heavy components Import heavy components at top level const Monaco = dynamic(() => import('./monaco'), { ssr: false }) import { MonacoEditor } from './monaco-editor' Critical
9 8 Bundle Size Defer Third Party analytics defer third-party React/Next.js Load analytics and logging after hydration since they don't block interaction Load non-critical scripts after hydration Include analytics in main bundle const Analytics = dynamic(() => import('@vercel/analytics'), { ssr: false }) import { Analytics } from '@vercel/analytics/react' Medium
10 9 Bundle Size Conditional Loading conditional module lazy React/Next.js Load large data or modules only when a feature is activated Dynamic import when feature enabled Import large modules unconditionally useEffect(() => { if (enabled) import('./heavy.js') }, [enabled]) import { heavyData } from './heavy.js' High
11 10 Bundle Size Preload Intent preload hover focus intent React/Next.js Preload heavy bundles on hover/focus before they're needed Preload on user intent signals Load only on click onMouseEnter={() => import('./editor')} onClick={() => import('./editor')} Medium
12 11 Server React.cache Dedup react cache deduplicate request React/Next.js Use React.cache() for server-side request deduplication within single request Wrap data fetchers with cache() Fetch same data multiple times in tree export const getUser = cache(async () => await db.user.find()) export async function getUser() { return await db.user.find() } Medium
13 12 Server LRU Cache Cross-Request lru cache cross request React/Next.js Use LRU cache for data shared across sequential requests Use LRU for cross-request caching Refetch same data on every request const cache = new LRUCache({ max: 1000, ttl: 5*60*1000 }) Always fetch from database High
14 13 Server Minimize Serialization serialization rsc boundary React/Next.js Only pass fields that client actually uses across RSC boundaries Pass only needed fields to client components Pass entire objects to client <Profile name={user.name} /> <Profile user={user} /> // 50 fields serialized High
15 14 Server Parallel Fetching parallel fetch component composition React/Next.js Restructure components to parallelize data fetching in RSC Use component composition for parallel fetches Sequential fetches in parent component <Header /><Sidebar /> // both fetch in parallel const header = await fetchHeader(); return <><div>{header}</div><Sidebar /></> Critical
16 15 Server After Non-blocking after non-blocking logging React/Next.js Use Next.js after() to schedule work after response is sent Use after() for logging/analytics Block response for non-critical operations after(async () => { await logAction() }); return Response.json(data) await logAction(); return Response.json(data) Medium
17 16 Client SWR Deduplication swr dedup cache revalidate React/Next.js Use SWR for automatic request deduplication and caching Use useSWR for client data fetching Manual fetch in useEffect const { data } = useSWR('/api/users', fetcher) useEffect(() => { fetch('/api/users').then(setUsers) }, []) Medium-High
18 17 Client Event Listener Dedup event listener deduplicate global React/Next.js Share global event listeners across component instances Use useSWRSubscription for shared listeners Register listener per component instance useSWRSubscription('global-keydown', () => { window.addEventListener... }) useEffect(() => { window.addEventListener('keydown', handler) }, []) Low
19 18 Rerender Defer State Reads state read callback subscription React/Next.js Don't subscribe to state only used in callbacks Read state on-demand in callbacks Subscribe to state used only in handlers const handleClick = () => { const params = new URLSearchParams(location.search) } const params = useSearchParams(); const handleClick = () => { params.get('ref') } Medium
20 19 Rerender Memoized Components memo extract expensive React/Next.js Extract expensive work into memoized components for early returns Extract to memo() components Compute expensive values before early return const UserAvatar = memo(({ user }) => ...); if (loading) return <Skeleton /> const avatar = useMemo(() => compute(user)); if (loading) return <Skeleton /> Medium
21 20 Rerender Narrow Dependencies effect dependency primitive React/Next.js Specify primitive dependencies instead of objects in effects Use primitive values in dependency arrays Use object references as dependencies useEffect(() => { console.log(user.id) }, [user.id]) useEffect(() => { console.log(user.id) }, [user]) Low
22 21 Rerender Derived State derived boolean subscription React/Next.js Subscribe to derived booleans instead of continuous values Use derived boolean state Subscribe to continuous values const isMobile = useMediaQuery('(max-width: 767px)') const width = useWindowWidth(); const isMobile = width < 768 Medium
23 22 Rerender Functional setState functional setstate callback React/Next.js Use functional setState updates for stable callbacks and no stale closures Use functional form: setState(curr => ...) Reference state directly in setState setItems(curr => [...curr, newItem]) setItems([...items, newItem]) // items in deps Medium
24 23 Rerender Lazy State Init usestate lazy initialization React/Next.js Pass function to useState for expensive initial values Use function form for expensive init Compute expensive value directly useState(() => buildSearchIndex(items)) useState(buildSearchIndex(items)) // runs every render Medium
25 24 Rerender Transitions starttransition non-urgent React/Next.js Mark frequent non-urgent state updates as transitions Use startTransition for non-urgent updates Block UI on every state change startTransition(() => setScrollY(window.scrollY)) setScrollY(window.scrollY) // blocks on every scroll Medium
26 25 Rendering SVG Animation Wrapper svg animation wrapper div React/Next.js Wrap SVG in div and animate wrapper for hardware acceleration Animate div wrapper around SVG Animate SVG element directly <div class='animate-spin'><svg>...</svg></div> <svg class='animate-spin'>...</svg> Low
27 26 Rendering Content Visibility content-visibility auto React/Next.js Apply content-visibility: auto to defer off-screen rendering Use content-visibility for long lists Render all list items immediately .item { content-visibility: auto; contain-intrinsic-size: 0 80px } Render 1000 items without optimization High
28 27 Rendering Hoist Static JSX hoist static jsx element React/Next.js Extract static JSX outside components to avoid re-creation Hoist static elements to module scope Create static elements inside components const skeleton = <div class='animate-pulse' />; function C() { return skeleton } function C() { return <div class='animate-pulse' /> } Low
29 28 Rendering Hydration No Flicker hydration mismatch flicker React/Next.js Use inline script to set client-only data before hydration Inject sync script for client-only values Use useEffect causing flash <script dangerouslySetInnerHTML={{ __html: 'el.className = localStorage.theme' }} /> useEffect(() => setTheme(localStorage.theme), []) // flickers Medium
30 29 Rendering Conditional Render conditional render ternary React/Next.js Use ternary instead of && when condition can be 0 or NaN Use explicit ternary for conditionals Use && with potentially falsy numbers {count > 0 ? <Badge>{count}</Badge> : null} {count && <Badge>{count}</Badge>} // renders '0' Low
31 30 Rendering Activity Component activity show hide preserve React/Next.js Use Activity component to preserve state/DOM for toggled components Use Activity for expensive toggle components Unmount/remount on visibility toggle <Activity mode={isOpen ? 'visible' : 'hidden'}><Menu /></Activity> {isOpen && <Menu />} // loses state Medium
32 31 JS Perf Batch DOM CSS batch dom css reflow React/Next.js Group CSS changes via classes or cssText to minimize reflows Use class toggle or cssText Change styles one property at a time element.classList.add('highlighted') el.style.width='100px'; el.style.height='200px' Medium
33 32 JS Perf Index Map Lookup map index lookup find React/Next.js Build Map for repeated lookups instead of multiple .find() calls Build index Map for O(1) lookups Use .find() in loops const byId = new Map(users.map(u => [u.id, u])); byId.get(id) users.find(u => u.id === order.userId) // O(n) each time Low-Medium
34 33 JS Perf Cache Property Access cache property loop React/Next.js Cache object property lookups in hot paths Cache values before loops Access nested properties in loops const val = obj.config.settings.value; for (...) process(val) for (...) process(obj.config.settings.value) Low-Medium
35 34 JS Perf Cache Function Results memoize cache function React/Next.js Use module-level Map to cache repeated function results Use Map cache for repeated calls Recompute same values repeatedly const cache = new Map(); if (cache.has(x)) return cache.get(x) slugify(name) // called 100 times same input Medium
36 35 JS Perf Cache Storage API localstorage cache read React/Next.js Cache localStorage/sessionStorage reads in memory Cache storage reads in Map Read storage on every call if (!cache.has(key)) cache.set(key, localStorage.getItem(key)) localStorage.getItem('theme') // every call Low-Medium
37 36 JS Perf Combine Iterations combine filter map loop React/Next.js Combine multiple filter/map into single loop Single loop for multiple categorizations Chain multiple filter() calls for (u of users) { if (u.isAdmin) admins.push(u); if (u.isTester) testers.push(u) } users.filter(admin); users.filter(tester); users.filter(inactive) Low-Medium
38 37 JS Perf Length Check First length check array compare React/Next.js Check array lengths before expensive comparisons Early return if lengths differ Always run expensive comparison if (a.length !== b.length) return true; // then compare a.sort().join() !== b.sort().join() // even when lengths differ Medium-High
39 38 JS Perf Early Return early return exit function React/Next.js Return early when result is determined to skip processing Return immediately on first error Process all items then check errors for (u of users) { if (!u.email) return { error: 'Email required' } } let hasError; for (...) { if (!email) hasError=true }; if (hasError)... Low-Medium
40 39 JS Perf Hoist RegExp regexp hoist module React/Next.js Don't create RegExp inside render - hoist or memoize Hoist RegExp to module scope Create RegExp every render const EMAIL_RE = /^[^@]+@[^@]+$/; function validate() { EMAIL_RE.test(x) } function C() { const re = new RegExp(pattern); re.test(x) } Low-Medium
41 40 JS Perf Loop Min Max loop min max sort React/Next.js Use loop for min/max instead of sort - O(n) vs O(n log n) Single pass loop for min/max Sort array to find min/max let max = arr[0]; for (x of arr) if (x > max) max = x arr.sort((a,b) => b-a)[0] // O(n log n) Low
42 41 JS Perf Set Map Lookups set map includes has React/Next.js Use Set/Map for O(1) lookups instead of array.includes() Convert to Set for membership checks Use .includes() for repeated checks const allowed = new Set(['a','b']); allowed.has(id) const allowed = ['a','b']; allowed.includes(id) Low-Medium
43 42 JS Perf toSorted Immutable tosorted sort immutable React/Next.js Use toSorted() instead of sort() to avoid mutating arrays Use toSorted() for immutability Mutate arrays with sort() users.toSorted((a,b) => a.name.localeCompare(b.name)) users.sort((a,b) => a.name.localeCompare(b.name)) // mutates Medium-High
44 43 Advanced Event Handler Refs useeffectevent ref handler React/Next.js Store callbacks in refs for stable effect subscriptions Use useEffectEvent for stable handlers Re-subscribe on every callback change const onEvent = useEffectEvent(handler); useEffect(() => { listen(onEvent) }, []) useEffect(() => { listen(handler) }, [handler]) // re-subscribes Low
45 44 Advanced useLatest Hook uselatest ref callback React/Next.js Access latest values in callbacks without adding to dependency arrays Use useLatest for fresh values in stable callbacks Add callback to effect dependencies const cbRef = useLatest(cb); useEffect(() => { setTimeout(() => cbRef.current()) }, []) useEffect(() => { setTimeout(() => cb()) }, [cb]) // re-runs Low

View File

@@ -0,0 +1,101 @@
No,UI_Category,Recommended_Pattern,Style_Priority,Color_Mood,Typography_Mood,Key_Effects,Decision_Rules,Anti_Patterns,Severity
1,SaaS (General),Hero + Features + CTA,Glassmorphism + Flat Design,Trust blue + Accent contrast,Professional + Hierarchy,Subtle hover (200-250ms) + Smooth transitions,"{""if_ux_focused"": ""prioritize-minimalism"", ""if_data_heavy"": ""add-glassmorphism""}",Excessive animation + Dark mode by default,HIGH
2,Micro SaaS,Minimal & Direct + Demo,Flat Design + Vibrant & Block,Vibrant primary + White space,Bold + Clean typography,Large CTA hover (300ms) + Scroll reveal,"{""if_quick_onboarding"": ""reduce-steps"", ""if_demo_available"": ""feature-interactive-demo""}",Complex onboarding flow + Cluttered layout,HIGH
3,E-commerce,Feature-Rich Showcase,Vibrant & Block-based,Brand primary + Success green,Engaging + Clear hierarchy,Card hover lift (200ms) + Scale effect,"{""if_luxury"": ""switch-to-liquid-glass"", ""if_conversion_focused"": ""add-urgency-colors""}",Flat design without depth + Text-heavy pages,HIGH
4,E-commerce Luxury,Feature-Rich Showcase,Liquid Glass + Glassmorphism,Premium colors + Minimal accent,Elegant + Refined typography,Chromatic aberration + Fluid animations (400-600ms),"{""if_checkout"": ""emphasize-trust"", ""if_hero_needed"": ""use-3d-hyperrealism""}",Vibrant & Block-based + Playful colors,HIGH
5,Healthcare App,Social Proof-Focused,Neumorphism + Accessible & Ethical,Calm blue + Health green,Readable + Large type (16px+),Soft box-shadow + Smooth press (150ms),"{""must_have"": ""wcag-aaa-compliance"", ""if_medication"": ""red-alert-colors""}",Bright neon colors + Motion-heavy animations + AI purple/pink gradients,HIGH
6,Fintech/Crypto,Conversion-Optimized,Glassmorphism + Dark Mode (OLED),Dark tech colors + Vibrant accents,Modern + Confident typography,Real-time chart animations + Alert pulse/glow,"{""must_have"": ""security-badges"", ""if_real_time"": ""add-streaming-data""}",Light backgrounds + No security indicators,HIGH
7,Education,Feature-Rich Showcase,Claymorphism + Micro-interactions,Playful colors + Clear hierarchy,Friendly + Engaging typography,Soft press (200ms) + Fluffy elements,"{""if_gamification"": ""add-progress-animation"", ""if_children"": ""increase-playfulness""}",Dark modes + Complex jargon,MEDIUM
8,Portfolio/Personal,Storytelling-Driven,Motion-Driven + Minimalism,Brand primary + Artistic,Expressive + Variable typography,Parallax (3-5 layers) + Scroll-triggered reveals,"{""if_creative_field"": ""add-brutalism"", ""if_minimal_portfolio"": ""reduce-motion""}",Corporate templates + Generic layouts,MEDIUM
9,Government/Public,Minimal & Direct,Accessible & Ethical + Minimalism,Professional blue + High contrast,Clear + Large typography,Clear focus rings (3-4px) + Skip links,"{""must_have"": ""wcag-aaa"", ""must_have"": ""keyboard-navigation""}",Ornate design + Low contrast + Motion effects + AI purple/pink gradients,HIGH
10,Fintech (Banking),Trust & Authority,Minimalism + Accessible & Ethical,Navy + Trust Blue + Gold,Professional + Trustworthy,Smooth state transitions + Number animations,"{""must_have"": ""security-first"", ""if_dashboard"": ""use-dark-mode""}",Playful design + Unclear fees + AI purple/pink gradients,HIGH
11,Social Media App,Feature-Rich Showcase,Vibrant & Block-based + Motion-Driven,Vibrant + Engagement colors,Modern + Bold typography,Large scroll animations + Icon animations,"{""if_engagement_metric"": ""add-motion"", ""if_content_focused"": ""minimize-chrome""}",Heavy skeuomorphism + Accessibility ignored,MEDIUM
12,Startup Landing,Hero-Centric + Trust,Motion-Driven + Vibrant & Block,Bold primaries + Accent contrast,Modern + Energetic typography,Scroll-triggered animations + Parallax,"{""if_pre_launch"": ""use-waitlist-pattern"", ""if_video_ready"": ""add-hero-video""}",Static design + No video + Poor mobile,HIGH
13,Gaming,Feature-Rich Showcase,3D & Hyperrealism + Retro-Futurism,Vibrant + Neon + Immersive,Bold + Impactful typography,WebGL 3D rendering + Glitch effects,"{""if_competitive"": ""add-real-time-stats"", ""if_casual"": ""increase-playfulness""}",Minimalist design + Static assets,HIGH
14,Creative Agency,Storytelling-Driven,Brutalism + Motion-Driven,Bold primaries + Artistic freedom,Bold + Expressive typography,CRT scanlines + Neon glow + Glitch effects,"{""must_have"": ""case-studies"", ""if_boutique"": ""increase-artistic-freedom""}",Corporate minimalism + Hidden portfolio,HIGH
15,Wellness/Mental Health,Social Proof-Focused,Neumorphism + Accessible & Ethical,Calm Pastels + Trust colors,Calming + Readable typography,Soft press + Breathing animations,"{""must_have"": ""privacy-first"", ""if_meditation"": ""add-breathing-animation""}",Bright neon + Motion overload,HIGH
16,Restaurant/Food,Hero-Centric + Conversion,Vibrant & Block-based + Motion-Driven,Warm colors (Orange Red Brown),Appetizing + Clear typography,Food image reveal + Menu hover effects,"{""must_have"": ""high_quality_images"", ""if_delivery"": ""emphasize-speed""}",Low-quality imagery + Outdated hours,HIGH
17,Real Estate,Hero-Centric + Feature-Rich,Glassmorphism + Minimalism,Trust Blue + Gold + White,Professional + Confident,3D property tour zoom + Map hover,"{""if_luxury"": ""add-3d-models"", ""must_have"": ""map-integration""}",Poor photos + No virtual tours,HIGH
18,Travel/Tourism,Storytelling-Driven + Hero,Aurora UI + Motion-Driven,Vibrant destination + Sky Blue,Inspirational + Engaging,Destination parallax + Itinerary animations,"{""if_experience_focused"": ""use-storytelling"", ""must_have"": ""mobile-booking""}",Generic photos + Complex booking,HIGH
19,SaaS Dashboard,Data-Dense Dashboard,Data-Dense + Heat Map,Cool to Hot gradients + Neutral grey,Clear + Readable typography,Hover tooltips + Chart zoom + Real-time pulse,"{""must_have"": ""real-time-updates"", ""if_large_dataset"": ""prioritize-performance""}",Ornate design + Slow rendering,HIGH
20,B2B SaaS Enterprise,Feature-Rich Showcase,Trust & Authority + Minimal,Professional blue + Neutral grey,Formal + Clear typography,Subtle section transitions + Feature reveals,"{""must_have"": ""case-studies"", ""must_have"": ""roi-messaging""}",Playful design + Hidden features + AI purple/pink gradients,HIGH
21,Music/Entertainment,Feature-Rich Showcase,Dark Mode (OLED) + Vibrant & Block-based,Dark (#121212) + Vibrant accents + Album art colors,Modern + Bold typography,Waveform visualization + Playlist animations,"{""must_have"": ""audio-player-ux"", ""if_discovery_focused"": ""add-playlist-recommendations""}",Cluttered layout + Poor audio player UX,HIGH
22,Video Streaming/OTT,Hero-Centric + Feature-Rich,Dark Mode (OLED) + Motion-Driven,Dark bg + Poster colors + Brand accent,Bold + Engaging typography,Video player animations + Content carousel (parallax),"{""must_have"": ""continue-watching"", ""if_personalized"": ""add-recommendations""}",Static layout + Slow video player,HIGH
23,Job Board/Recruitment,Conversion-Optimized + Feature-Rich,Flat Design + Minimalism,Professional Blue + Success Green + Neutral,Clear + Professional typography,Search/filter animations + Application flow,"{""must_have"": ""advanced-search"", ""if_salary_focused"": ""highlight-compensation""}",Outdated forms + Hidden filters,HIGH
24,Marketplace (P2P),Feature-Rich Showcase + Social Proof,Vibrant & Block-based + Flat Design,Trust colors + Category colors + Success green,Modern + Engaging typography,Review star animations + Listing hover effects,"{""must_have"": ""seller-profiles"", ""must_have"": ""secure-payment""}",Low trust signals + Confusing layout,HIGH
25,Logistics/Delivery,Feature-Rich Showcase + Real-Time,Minimalism + Flat Design,Blue (#2563EB) + Orange (tracking) + Green,Clear + Functional typography,Real-time tracking animation + Status pulse,"{""must_have"": ""tracking-map"", ""must_have"": ""delivery-updates""}",Static tracking + No map integration + AI purple/pink gradients,HIGH
26,Agriculture/Farm Tech,Feature-Rich Showcase,Organic Biophilic + Flat Design,Earth Green (#4A7C23) + Brown + Sky Blue,Clear + Informative typography,Data visualization + Weather animations,"{""must_have"": ""sensor-dashboard"", ""if_crop_focused"": ""add-health-indicators""}",Generic design + Ignored accessibility + AI purple/pink gradients,MEDIUM
27,Construction/Architecture,Hero-Centric + Feature-Rich,Minimalism + 3D & Hyperrealism,Grey (#4A4A4A) + Orange (safety) + Blueprint Blue,Professional + Bold typography,3D model viewer + Timeline animations,"{""must_have"": ""project-portfolio"", ""if_team_collaboration"": ""add-real-time-updates""}",2D-only layouts + Poor image quality + AI purple/pink gradients,HIGH
28,Automotive/Car Dealership,Hero-Centric + Feature-Rich,Motion-Driven + 3D & Hyperrealism,Brand colors + Metallic + Dark/Light,Bold + Confident typography,360 product view + Configurator animations,"{""must_have"": ""vehicle-comparison"", ""must_have"": ""financing-calculator""}",Static product pages + Poor UX,HIGH
29,Photography Studio,Storytelling-Driven + Hero-Centric,Motion-Driven + Minimalism,Black + White + Minimal accent,Elegant + Minimal typography,Full-bleed gallery + Before/after reveal,"{""must_have"": ""portfolio-showcase"", ""if_booking"": ""add-calendar-system""}",Heavy text + Poor image showcase,HIGH
30,Coworking Space,Hero-Centric + Feature-Rich,Vibrant & Block-based + Glassmorphism,Energetic colors + Wood tones + Brand,Modern + Engaging typography,Space tour video + Amenity reveal animations,"{""must_have"": ""virtual-tour"", ""must_have"": ""booking-system""}",Outdated photos + Confusing layout,MEDIUM
31,Cleaning Service,Conversion-Optimized + Trust,Soft UI Evolution + Flat Design,Fresh Blue (#00B4D8) + Clean White + Green,Friendly + Clear typography,Before/after gallery + Service package reveal,"{""must_have"": ""price-transparency"", ""must_have"": ""trust-badges""}",Poor before/after imagery + Hidden pricing,HIGH
32,Home Services,Conversion-Optimized + Trust,Flat Design + Trust & Authority,Trust Blue + Safety Orange + Grey,Professional + Clear typography,Emergency contact highlight + Service menu animations,"{""must_have"": ""emergency-contact"", ""must_have"": ""certifications-display""}",Hidden contact info + No certifications,HIGH
33,Childcare/Daycare,Social Proof-Focused + Trust,Claymorphism + Vibrant & Block-based,Playful pastels + Safe colors + Warm,Friendly + Playful typography,Parent portal animations + Activity gallery reveal,"{""must_have"": ""parent-communication"", ""must_have"": ""safety-certifications""}",Generic design + Hidden safety info,HIGH
34,Senior Care/Elderly,Trust & Authority + Accessible,Accessible & Ethical + Soft UI Evolution,Calm Blue + Warm neutrals + Large text,Large + Clear typography (18px+),Large touch targets + Clear navigation,"{""must_have"": ""wcag-aaa"", ""must_have"": ""family-portal""}",Small text + Complex navigation + AI purple/pink gradients,HIGH
35,Medical Clinic,Trust & Authority + Conversion,Accessible & Ethical + Minimalism,Medical Blue (#0077B6) + Trust White,Professional + Readable typography,Online booking flow + Doctor profile reveals,"{""must_have"": ""appointment-booking"", ""must_have"": ""insurance-info""}",Outdated interface + Confusing booking + AI purple/pink gradients,HIGH
36,Pharmacy/Drug Store,Conversion-Optimized + Trust,Flat Design + Accessible & Ethical,Pharmacy Green + Trust Blue + Clean White,Clear + Functional typography,Prescription upload flow + Refill reminders,"{""must_have"": ""prescription-management"", ""must_have"": ""drug-interaction-warnings""}",Confusing layout + Privacy concerns + AI purple/pink gradients,HIGH
37,Dental Practice,Social Proof-Focused + Conversion,Soft UI Evolution + Minimalism,Fresh Blue + White + Smile Yellow,Friendly + Professional typography,Before/after gallery + Patient testimonial carousel,"{""must_have"": ""before-after-gallery"", ""must_have"": ""appointment-system""}",Poor imagery + No testimonials,HIGH
38,Veterinary Clinic,Social Proof-Focused + Trust,Claymorphism + Accessible & Ethical,Caring Blue + Pet colors + Warm,Friendly + Welcoming typography,Pet profile management + Service animations,"{""must_have"": ""pet-portal"", ""must_have"": ""emergency-contact""}",Generic design + Hidden services,MEDIUM
39,News/Media Platform,Hero-Centric + Feature-Rich,Minimalism + Flat Design,Brand colors + High contrast,Clear + Readable typography,Breaking news badge + Article reveal animations,"{""must_have"": ""mobile-first-reading"", ""must_have"": ""category-navigation""}",Cluttered layout + Slow loading,HIGH
40,Legal Services,Trust & Authority + Minimal,Trust & Authority + Minimalism,Navy Blue (#1E3A5F) + Gold + White,Professional + Authoritative typography,Practice area reveal + Attorney profile animations,"{""must_have"": ""case-results"", ""must_have"": ""credential-display""}",Outdated design + Hidden credentials + AI purple/pink gradients,HIGH
41,Beauty/Spa/Wellness Service,Hero-Centric + Social Proof,Soft UI Evolution + Neumorphism,Soft pastels (Pink Sage Cream) + Gold accents,Elegant + Calming typography,Soft shadows + Smooth transitions (200-300ms) + Gentle hover,"{""must_have"": ""booking-system"", ""must_have"": ""before-after-gallery"", ""if_luxury"": ""add-gold-accents""}",Bright neon colors + Harsh animations + Dark mode,HIGH
42,Service Landing Page,Hero-Centric + Trust & Authority,Minimalism + Social Proof-Focused,Brand primary + Trust colors,Professional + Clear typography,Testimonial carousel + CTA hover (200ms),"{""must_have"": ""social-proof"", ""must_have"": ""clear-cta""}",Complex navigation + Hidden contact info,HIGH
43,B2B Service,Feature-Rich Showcase + Trust,Trust & Authority + Minimalism,Professional blue + Neutral grey,Formal + Clear typography,Section transitions + Feature reveals,"{""must_have"": ""case-studies"", ""must_have"": ""roi-messaging""}",Playful design + Hidden credentials + AI purple/pink gradients,HIGH
44,Financial Dashboard,Data-Dense Dashboard,Dark Mode (OLED) + Data-Dense,Dark bg + Red/Green alerts + Trust blue,Clear + Readable typography,Real-time number animations + Alert pulse,"{""must_have"": ""real-time-updates"", ""must_have"": ""high-contrast""}",Light mode default + Slow rendering,HIGH
45,Analytics Dashboard,Data-Dense + Drill-Down,Data-Dense + Heat Map,Cool→Hot gradients + Neutral grey,Clear + Functional typography,Hover tooltips + Chart zoom + Filter animations,"{""must_have"": ""data-export"", ""if_large_dataset"": ""virtualize-lists""}",Ornate design + No filtering,HIGH
46,Productivity Tool,Interactive Demo + Feature-Rich,Flat Design + Micro-interactions,Clear hierarchy + Functional colors,Clean + Efficient typography,Quick actions (150ms) + Task animations,"{""must_have"": ""keyboard-shortcuts"", ""if_collaboration"": ""add-real-time-cursors""}",Complex onboarding + Slow performance,HIGH
47,Design System/Component Library,Feature-Rich + Documentation,Minimalism + Accessible & Ethical,Clear hierarchy + Code-like structure,Monospace + Clear typography,Code copy animations + Component previews,"{""must_have"": ""search"", ""must_have"": ""code-examples""}",Poor documentation + No live preview,HIGH
48,AI/Chatbot Platform,Interactive Demo + Minimal,AI-Native UI + Minimalism,Neutral + AI Purple (#6366F1),Modern + Clear typography,Streaming text + Typing indicators + Fade-in,"{""must_have"": ""conversational-ui"", ""must_have"": ""context-awareness""}",Heavy chrome + Slow response feedback,HIGH
49,NFT/Web3 Platform,Feature-Rich Showcase,Cyberpunk UI + Glassmorphism,Dark + Neon + Gold (#FFD700),Bold + Modern typography,Wallet connect animations + Transaction feedback,"{""must_have"": ""wallet-integration"", ""must_have"": ""gas-fees-display""}",Light mode default + No transaction status,HIGH
50,Creator Economy Platform,Social Proof + Feature-Rich,Vibrant & Block-based + Bento Box Grid,Vibrant + Brand colors,Modern + Bold typography,Engagement counter animations + Profile reveals,"{""must_have"": ""creator-profiles"", ""must_have"": ""monetization-display""}",Generic layout + Hidden earnings,MEDIUM
51,Sustainability/ESG Platform,Trust & Authority + Data,Organic Biophilic + Minimalism,Green (#228B22) + Earth tones,Clear + Informative typography,Progress indicators + Impact animations,"{""must_have"": ""data-transparency"", ""must_have"": ""certification-badges""}",Greenwashing visuals + No data,HIGH
52,Remote Work/Collaboration,Feature-Rich + Real-Time,Soft UI Evolution + Minimalism,Calm Blue + Neutral grey,Clean + Readable typography,Real-time presence indicators + Notification badges,"{""must_have"": ""status-indicators"", ""must_have"": ""video-integration""}",Cluttered interface + No presence,HIGH
53,Pet Tech App,Storytelling + Feature-Rich,Claymorphism + Vibrant & Block-based,Playful + Warm colors,Friendly + Playful typography,Pet profile animations + Health tracking charts,"{""must_have"": ""pet-profiles"", ""if_health"": ""add-vet-integration""}",Generic design + No personality,MEDIUM
54,Smart Home/IoT Dashboard,Real-Time Monitoring,Glassmorphism + Dark Mode (OLED),Dark + Status indicator colors,Clear + Functional typography,Device status pulse + Quick action animations,"{""must_have"": ""real-time-controls"", ""must_have"": ""energy-monitoring""}",Slow updates + No automation,HIGH
55,EV/Charging Ecosystem,Hero-Centric + Feature-Rich,Minimalism + Aurora UI,Electric Blue (#009CD1) + Green,Modern + Clear typography,Range estimation animations + Map interactions,"{""must_have"": ""charging-map"", ""must_have"": ""range-calculator""}",Poor map UX + Hidden costs,HIGH
56,Subscription Box Service,Feature-Rich + Conversion,Vibrant & Block-based + Motion-Driven,Brand + Excitement colors,Engaging + Clear typography,Unboxing reveal animations + Product carousel,"{""must_have"": ""personalization-quiz"", ""must_have"": ""subscription-management""}",Confusing pricing + No unboxing preview,HIGH
57,Podcast Platform,Storytelling + Feature-Rich,Dark Mode (OLED) + Minimalism,Dark + Audio waveform accents,Modern + Clear typography,Waveform visualizations + Episode transitions,"{""must_have"": ""audio-player-ux"", ""must_have"": ""episode-discovery""}",Poor audio player + Cluttered layout,HIGH
58,Dating App,Social Proof + Feature-Rich,Vibrant & Block-based + Motion-Driven,Warm + Romantic (Pink/Red gradients),Modern + Friendly typography,Profile card swipe + Match animations,"{""must_have"": ""profile-cards"", ""must_have"": ""safety-features""}",Generic profiles + No safety,HIGH
59,Micro-Credentials/Badges,Trust & Authority + Feature,Minimalism + Flat Design,Trust Blue + Gold (#FFD700),Professional + Clear typography,Badge reveal animations + Progress tracking,"{""must_have"": ""credential-verification"", ""must_have"": ""progress-display""}",No verification + Hidden progress,MEDIUM
60,Knowledge Base/Documentation,FAQ + Minimal,Minimalism + Accessible & Ethical,Clean hierarchy + Minimal color,Clear + Readable typography,Search highlight + Smooth scrolling,"{""must_have"": ""search-first"", ""must_have"": ""version-switching""}",Poor navigation + No search,HIGH
61,Hyperlocal Services,Conversion + Feature-Rich,Minimalism + Vibrant & Block-based,Location markers + Trust colors,Clear + Functional typography,Map hover + Provider card reveals,"{""must_have"": ""map-integration"", ""must_have"": ""booking-system""}",No map + Hidden reviews,HIGH
62,Luxury/Premium Brand,Storytelling + Feature-Rich,Liquid Glass + Glassmorphism,Black + Gold (#FFD700) + White,Elegant + Refined typography,Slow parallax + Premium reveals (400-600ms),"{""must_have"": ""high-quality-imagery"", ""must_have"": ""storytelling""}",Cheap visuals + Fast animations,HIGH
63,Fitness/Gym App,Feature-Rich + Data,Vibrant & Block-based + Dark Mode (OLED),Energetic (Orange #FF6B35) + Dark bg,Bold + Motivational typography,Progress ring animations + Achievement unlocks,"{""must_have"": ""progress-tracking"", ""must_have"": ""workout-plans""}",Static design + No gamification,HIGH
64,Hotel/Hospitality,Hero-Centric + Social Proof,Liquid Glass + Minimalism,Warm neutrals + Gold (#D4AF37),Elegant + Welcoming typography,Room gallery + Amenity reveals,"{""must_have"": ""room-booking"", ""must_have"": ""virtual-tour""}",Poor photos + Complex booking,HIGH
65,Wedding/Event Planning,Storytelling + Social Proof,Soft UI Evolution + Aurora UI,Soft Pink (#FFD6E0) + Gold + Cream,Elegant + Romantic typography,Gallery reveals + Timeline animations,"{""must_have"": ""portfolio-gallery"", ""must_have"": ""planning-tools""}",Generic templates + No portfolio,HIGH
66,Insurance Platform,Conversion + Trust,Trust & Authority + Flat Design,Trust Blue (#0066CC) + Green + Neutral,Clear + Professional typography,Quote calculator animations + Policy comparison,"{""must_have"": ""quote-calculator"", ""must_have"": ""policy-comparison""}",Confusing pricing + No trust signals + AI purple/pink gradients,HIGH
67,Banking/Traditional Finance,Trust & Authority + Feature,Minimalism + Accessible & Ethical,Navy (#0A1628) + Trust Blue + Gold,Professional + Trustworthy typography,Smooth number animations + Security indicators,"{""must_have"": ""security-first"", ""must_have"": ""accessibility""}",Playful design + Poor security UX + AI purple/pink gradients,HIGH
68,Online Course/E-learning,Feature-Rich + Social Proof,Claymorphism + Vibrant & Block-based,Vibrant learning colors + Progress green,Friendly + Engaging typography,Progress bar animations + Certificate reveals,"{""must_have"": ""progress-tracking"", ""must_have"": ""video-player""}",Boring design + No gamification,HIGH
69,Non-profit/Charity,Storytelling + Trust,Accessible & Ethical + Organic Biophilic,Cause-related colors + Trust + Warm,Heartfelt + Readable typography,Impact counter animations + Story reveals,"{""must_have"": ""impact-stories"", ""must_have"": ""donation-transparency""}",No impact data + Hidden financials,HIGH
70,Florist/Plant Shop,Hero-Centric + Conversion,Organic Biophilic + Vibrant & Block-based,Natural Green + Floral pinks/purples,Elegant + Natural typography,Product reveal + Seasonal transitions,"{""must_have"": ""delivery-scheduling"", ""must_have"": ""care-guides""}",Poor imagery + No seasonal content,MEDIUM
71,Bakery/Cafe,Hero-Centric + Conversion,Vibrant & Block-based + Soft UI Evolution,Warm Brown + Cream + Appetizing accents,Warm + Inviting typography,Menu hover + Order animations,"{""must_have"": ""menu-display"", ""must_have"": ""online-ordering""}",Poor food photos + Hidden hours,HIGH
72,Coffee Shop,Hero-Centric + Minimal,Minimalism + Organic Biophilic,Coffee Brown (#6F4E37) + Cream + Warm,Cozy + Clean typography,Menu transitions + Loyalty animations,"{""must_have"": ""menu"", ""if_loyalty"": ""add-rewards-system""}",Generic design + No atmosphere,MEDIUM
73,Brewery/Winery,Storytelling + Hero-Centric,Motion-Driven + Storytelling-Driven,Deep amber/burgundy + Gold + Craft,Artisanal + Heritage typography,Tasting note reveals + Heritage timeline,"{""must_have"": ""product-showcase"", ""must_have"": ""story-heritage""}",Generic product pages + No story,HIGH
74,Airline,Conversion + Feature-Rich,Minimalism + Glassmorphism,Sky Blue + Brand colors + Trust,Clear + Professional typography,Flight search animations + Boarding pass reveals,"{""must_have"": ""flight-search"", ""must_have"": ""mobile-first""}",Complex booking + Poor mobile,HIGH
75,Magazine/Blog,Storytelling + Hero-Centric,Swiss Modernism 2.0 + Motion-Driven,Editorial colors + Brand + Clean white,Editorial + Elegant typography,Article transitions + Category reveals,"{""must_have"": ""article-showcase"", ""must_have"": ""newsletter-signup""}",Poor typography + Slow loading,HIGH
76,Freelancer Platform,Feature-Rich + Conversion,Flat Design + Minimalism,Professional Blue + Success Green,Clear + Professional typography,Skill match animations + Review reveals,"{""must_have"": ""portfolio-display"", ""must_have"": ""skill-matching""}",Poor profiles + No reviews,HIGH
77,Consulting Firm,Trust & Authority + Minimal,Trust & Authority + Minimalism,Navy + Gold + Professional grey,Authoritative + Clear typography,Case study reveals + Team profiles,"{""must_have"": ""case-studies"", ""must_have"": ""thought-leadership""}",Generic content + No credentials + AI purple/pink gradients,HIGH
78,Marketing Agency,Storytelling + Feature-Rich,Brutalism + Motion-Driven,Bold brand colors + Creative freedom,Bold + Expressive typography,Portfolio reveals + Results animations,"{""must_have"": ""portfolio"", ""must_have"": ""results-metrics""}",Boring design + Hidden work,HIGH
79,Event Management,Hero-Centric + Feature-Rich,Vibrant & Block-based + Motion-Driven,Event theme colors + Excitement accents,Bold + Engaging typography,Countdown timer + Registration flow,"{""must_have"": ""registration"", ""must_have"": ""agenda-display""}",Confusing registration + No countdown,HIGH
80,Conference/Webinar Platform,Feature-Rich + Conversion,Glassmorphism + Minimalism,Professional Blue + Video accent,Professional + Clear typography,Live stream integration + Agenda transitions,"{""must_have"": ""registration"", ""must_have"": ""speaker-profiles""}",Poor video UX + No networking,HIGH
81,Membership/Community,Social Proof + Conversion,Vibrant & Block-based + Soft UI Evolution,Community brand colors + Engagement,Friendly + Engaging typography,Member counter + Benefit reveals,"{""must_have"": ""member-benefits"", ""must_have"": ""pricing-tiers""}",Hidden benefits + No community proof,HIGH
82,Newsletter Platform,Minimal + Conversion,Minimalism + Flat Design,Brand primary + Clean white + CTA,Clean + Readable typography,Subscribe form + Archive reveals,"{""must_have"": ""subscribe-form"", ""must_have"": ""sample-content""}",Complex signup + No preview,MEDIUM
83,Digital Products/Downloads,Feature-Rich + Conversion,Vibrant & Block-based + Motion-Driven,Product colors + Brand + Success green,Modern + Clear typography,Product preview + Instant delivery animations,"{""must_have"": ""product-preview"", ""must_have"": ""instant-delivery""}",No preview + Slow delivery,HIGH
84,Church/Religious Organization,Hero-Centric + Social Proof,Accessible & Ethical + Soft UI Evolution,Warm Gold + Deep Purple/Blue + White,Welcoming + Clear typography,Service time highlights + Event calendar,"{""must_have"": ""service-times"", ""must_have"": ""community-events""}",Outdated design + Hidden info,MEDIUM
85,Sports Team/Club,Hero-Centric + Feature-Rich,Vibrant & Block-based + Motion-Driven,Team colors + Energetic accents,Bold + Impactful typography,Score animations + Schedule reveals,"{""must_have"": ""schedule"", ""must_have"": ""roster""}",Static content + Poor fan engagement,HIGH
86,Museum/Gallery,Storytelling + Feature-Rich,Minimalism + Motion-Driven,Art-appropriate neutrals + Exhibition accents,Elegant + Minimal typography,Virtual tour + Collection reveals,"{""must_have"": ""virtual-tour"", ""must_have"": ""exhibition-info""}",Cluttered layout + No online access,HIGH
87,Theater/Cinema,Hero-Centric + Conversion,Dark Mode (OLED) + Motion-Driven,Dark + Spotlight accents + Gold,Dramatic + Bold typography,Seat selection + Trailer reveals,"{""must_have"": ""showtimes"", ""must_have"": ""seat-selection""}",Poor booking UX + No trailers,HIGH
88,Language Learning App,Feature-Rich + Social Proof,Claymorphism + Vibrant & Block-based,Playful colors + Progress indicators,Friendly + Clear typography,Progress animations + Achievement unlocks,"{""must_have"": ""progress-tracking"", ""must_have"": ""gamification""}",Boring design + No motivation,HIGH
89,Coding Bootcamp,Feature-Rich + Social Proof,Dark Mode (OLED) + Minimalism,Code editor colors + Brand + Success,Technical + Clear typography,Terminal animations + Career outcome reveals,"{""must_have"": ""curriculum"", ""must_have"": ""career-outcomes""}",Light mode only + Hidden results,HIGH
90,Cybersecurity Platform,Trust & Authority + Real-Time,Cyberpunk UI + Dark Mode (OLED),Matrix Green (#00FF00) + Deep Black,Technical + Clear typography,Threat visualization + Alert animations,"{""must_have"": ""real-time-monitoring"", ""must_have"": ""threat-display""}",Light mode + Poor data viz,HIGH
91,Developer Tool/IDE,Minimal + Documentation,Dark Mode (OLED) + Minimalism,Dark syntax theme + Blue focus,Monospace + Functional typography,Syntax highlighting + Command palette,"{""must_have"": ""keyboard-shortcuts"", ""must_have"": ""documentation""}",Light mode default + Slow performance,HIGH
92,Biotech/Life Sciences,Storytelling + Data,Glassmorphism + Clean Science,Sterile White + DNA Blue + Life Green,Scientific + Clear typography,Data visualization + Research reveals,"{""must_have"": ""data-accuracy"", ""must_have"": ""clean-aesthetic""}",Cluttered data + Poor credibility,HIGH
93,Space Tech/Aerospace,Immersive + Feature-Rich,Holographic/HUD + Dark Mode,Deep Space Black + Star White + Metallic,Futuristic + Precise typography,Telemetry animations + 3D renders,"{""must_have"": ""high-tech-feel"", ""must_have"": ""precision-data""}",Generic design + No immersion,HIGH
94,Architecture/Interior,Portfolio + Hero-Centric,Exaggerated Minimalism + High Imagery,Monochrome + Gold Accent + High Imagery,Architectural + Elegant typography,Project gallery + Blueprint reveals,"{""must_have"": ""high-res-images"", ""must_have"": ""project-portfolio""}",Poor imagery + Cluttered layout,HIGH
95,Quantum Computing,Immersive + Interactive,Holographic/HUD + Dark Mode,Quantum Blue (#00FFFF) + Deep Black,Futuristic + Scientific typography,Probability visualizations + Qubit state animations,"{""must_have"": ""complexity-visualization"", ""must_have"": ""scientific-credibility""}",Generic tech design + No viz,HIGH
96,Biohacking/Longevity App,Data-Dense + Storytelling,Biomimetic/Organic 2.0 + Minimalism,Cellular Pink/Red + DNA Blue + White,Scientific + Clear typography,Biological data viz + Progress animations,"{""must_have"": ""data-privacy"", ""must_have"": ""scientific-credibility""}",Generic health app + No privacy,HIGH
97,Autonomous Drone Fleet,Real-Time + Feature-Rich,HUD/Sci-Fi FUI + Real-Time,Tactical Green + Alert Red + Map Dark,Technical + Functional typography,Telemetry animations + 3D spatial awareness,"{""must_have"": ""real-time-telemetry"", ""must_have"": ""safety-alerts""}",Slow updates + Poor spatial viz,HIGH
98,Generative Art Platform,Showcase + Feature-Rich,Minimalism + Gen Z Chaos,Neutral (#F5F5F5) + User Content,Minimal + Content-focused typography,Gallery masonry + Minting animations,"{""must_have"": ""fast-loading"", ""must_have"": ""creator-attribution""}",Heavy chrome + Slow loading,HIGH
99,Spatial Computing OS,Immersive + Interactive,Spatial UI (VisionOS) + Glassmorphism,Frosted Glass + System Colors + Depth,Spatial + Readable typography,Depth hierarchy + Gaze interactions,"{""must_have"": ""depth-hierarchy"", ""must_have"": ""environment-awareness""}",2D design + No spatial depth,HIGH
100,Sustainable Energy/Climate,Data + Trust,Organic Biophilic + E-Ink/Paper,Earth Green + Sky Blue + Solar Yellow,Clear + Informative typography,Impact viz + Progress animations,"{""must_have"": ""data-transparency"", ""must_have"": ""impact-visualization""}",Greenwashing + No real data,HIGH
1 No UI_Category Recommended_Pattern Style_Priority Color_Mood Typography_Mood Key_Effects Decision_Rules Anti_Patterns Severity
2 1 SaaS (General) Hero + Features + CTA Glassmorphism + Flat Design Trust blue + Accent contrast Professional + Hierarchy Subtle hover (200-250ms) + Smooth transitions {"if_ux_focused": "prioritize-minimalism", "if_data_heavy": "add-glassmorphism"} Excessive animation + Dark mode by default HIGH
3 2 Micro SaaS Minimal & Direct + Demo Flat Design + Vibrant & Block Vibrant primary + White space Bold + Clean typography Large CTA hover (300ms) + Scroll reveal {"if_quick_onboarding": "reduce-steps", "if_demo_available": "feature-interactive-demo"} Complex onboarding flow + Cluttered layout HIGH
4 3 E-commerce Feature-Rich Showcase Vibrant & Block-based Brand primary + Success green Engaging + Clear hierarchy Card hover lift (200ms) + Scale effect {"if_luxury": "switch-to-liquid-glass", "if_conversion_focused": "add-urgency-colors"} Flat design without depth + Text-heavy pages HIGH
5 4 E-commerce Luxury Feature-Rich Showcase Liquid Glass + Glassmorphism Premium colors + Minimal accent Elegant + Refined typography Chromatic aberration + Fluid animations (400-600ms) {"if_checkout": "emphasize-trust", "if_hero_needed": "use-3d-hyperrealism"} Vibrant & Block-based + Playful colors HIGH
6 5 Healthcare App Social Proof-Focused Neumorphism + Accessible & Ethical Calm blue + Health green Readable + Large type (16px+) Soft box-shadow + Smooth press (150ms) {"must_have": "wcag-aaa-compliance", "if_medication": "red-alert-colors"} Bright neon colors + Motion-heavy animations + AI purple/pink gradients HIGH
7 6 Fintech/Crypto Conversion-Optimized Glassmorphism + Dark Mode (OLED) Dark tech colors + Vibrant accents Modern + Confident typography Real-time chart animations + Alert pulse/glow {"must_have": "security-badges", "if_real_time": "add-streaming-data"} Light backgrounds + No security indicators HIGH
8 7 Education Feature-Rich Showcase Claymorphism + Micro-interactions Playful colors + Clear hierarchy Friendly + Engaging typography Soft press (200ms) + Fluffy elements {"if_gamification": "add-progress-animation", "if_children": "increase-playfulness"} Dark modes + Complex jargon MEDIUM
9 8 Portfolio/Personal Storytelling-Driven Motion-Driven + Minimalism Brand primary + Artistic Expressive + Variable typography Parallax (3-5 layers) + Scroll-triggered reveals {"if_creative_field": "add-brutalism", "if_minimal_portfolio": "reduce-motion"} Corporate templates + Generic layouts MEDIUM
10 9 Government/Public Minimal & Direct Accessible & Ethical + Minimalism Professional blue + High contrast Clear + Large typography Clear focus rings (3-4px) + Skip links {"must_have": "wcag-aaa", "must_have": "keyboard-navigation"} Ornate design + Low contrast + Motion effects + AI purple/pink gradients HIGH
11 10 Fintech (Banking) Trust & Authority Minimalism + Accessible & Ethical Navy + Trust Blue + Gold Professional + Trustworthy Smooth state transitions + Number animations {"must_have": "security-first", "if_dashboard": "use-dark-mode"} Playful design + Unclear fees + AI purple/pink gradients HIGH
12 11 Social Media App Feature-Rich Showcase Vibrant & Block-based + Motion-Driven Vibrant + Engagement colors Modern + Bold typography Large scroll animations + Icon animations {"if_engagement_metric": "add-motion", "if_content_focused": "minimize-chrome"} Heavy skeuomorphism + Accessibility ignored MEDIUM
13 12 Startup Landing Hero-Centric + Trust Motion-Driven + Vibrant & Block Bold primaries + Accent contrast Modern + Energetic typography Scroll-triggered animations + Parallax {"if_pre_launch": "use-waitlist-pattern", "if_video_ready": "add-hero-video"} Static design + No video + Poor mobile HIGH
14 13 Gaming Feature-Rich Showcase 3D & Hyperrealism + Retro-Futurism Vibrant + Neon + Immersive Bold + Impactful typography WebGL 3D rendering + Glitch effects {"if_competitive": "add-real-time-stats", "if_casual": "increase-playfulness"} Minimalist design + Static assets HIGH
15 14 Creative Agency Storytelling-Driven Brutalism + Motion-Driven Bold primaries + Artistic freedom Bold + Expressive typography CRT scanlines + Neon glow + Glitch effects {"must_have": "case-studies", "if_boutique": "increase-artistic-freedom"} Corporate minimalism + Hidden portfolio HIGH
16 15 Wellness/Mental Health Social Proof-Focused Neumorphism + Accessible & Ethical Calm Pastels + Trust colors Calming + Readable typography Soft press + Breathing animations {"must_have": "privacy-first", "if_meditation": "add-breathing-animation"} Bright neon + Motion overload HIGH
17 16 Restaurant/Food Hero-Centric + Conversion Vibrant & Block-based + Motion-Driven Warm colors (Orange Red Brown) Appetizing + Clear typography Food image reveal + Menu hover effects {"must_have": "high_quality_images", "if_delivery": "emphasize-speed"} Low-quality imagery + Outdated hours HIGH
18 17 Real Estate Hero-Centric + Feature-Rich Glassmorphism + Minimalism Trust Blue + Gold + White Professional + Confident 3D property tour zoom + Map hover {"if_luxury": "add-3d-models", "must_have": "map-integration"} Poor photos + No virtual tours HIGH
19 18 Travel/Tourism Storytelling-Driven + Hero Aurora UI + Motion-Driven Vibrant destination + Sky Blue Inspirational + Engaging Destination parallax + Itinerary animations {"if_experience_focused": "use-storytelling", "must_have": "mobile-booking"} Generic photos + Complex booking HIGH
20 19 SaaS Dashboard Data-Dense Dashboard Data-Dense + Heat Map Cool to Hot gradients + Neutral grey Clear + Readable typography Hover tooltips + Chart zoom + Real-time pulse {"must_have": "real-time-updates", "if_large_dataset": "prioritize-performance"} Ornate design + Slow rendering HIGH
21 20 B2B SaaS Enterprise Feature-Rich Showcase Trust & Authority + Minimal Professional blue + Neutral grey Formal + Clear typography Subtle section transitions + Feature reveals {"must_have": "case-studies", "must_have": "roi-messaging"} Playful design + Hidden features + AI purple/pink gradients HIGH
22 21 Music/Entertainment Feature-Rich Showcase Dark Mode (OLED) + Vibrant & Block-based Dark (#121212) + Vibrant accents + Album art colors Modern + Bold typography Waveform visualization + Playlist animations {"must_have": "audio-player-ux", "if_discovery_focused": "add-playlist-recommendations"} Cluttered layout + Poor audio player UX HIGH
23 22 Video Streaming/OTT Hero-Centric + Feature-Rich Dark Mode (OLED) + Motion-Driven Dark bg + Poster colors + Brand accent Bold + Engaging typography Video player animations + Content carousel (parallax) {"must_have": "continue-watching", "if_personalized": "add-recommendations"} Static layout + Slow video player HIGH
24 23 Job Board/Recruitment Conversion-Optimized + Feature-Rich Flat Design + Minimalism Professional Blue + Success Green + Neutral Clear + Professional typography Search/filter animations + Application flow {"must_have": "advanced-search", "if_salary_focused": "highlight-compensation"} Outdated forms + Hidden filters HIGH
25 24 Marketplace (P2P) Feature-Rich Showcase + Social Proof Vibrant & Block-based + Flat Design Trust colors + Category colors + Success green Modern + Engaging typography Review star animations + Listing hover effects {"must_have": "seller-profiles", "must_have": "secure-payment"} Low trust signals + Confusing layout HIGH
26 25 Logistics/Delivery Feature-Rich Showcase + Real-Time Minimalism + Flat Design Blue (#2563EB) + Orange (tracking) + Green Clear + Functional typography Real-time tracking animation + Status pulse {"must_have": "tracking-map", "must_have": "delivery-updates"} Static tracking + No map integration + AI purple/pink gradients HIGH
27 26 Agriculture/Farm Tech Feature-Rich Showcase Organic Biophilic + Flat Design Earth Green (#4A7C23) + Brown + Sky Blue Clear + Informative typography Data visualization + Weather animations {"must_have": "sensor-dashboard", "if_crop_focused": "add-health-indicators"} Generic design + Ignored accessibility + AI purple/pink gradients MEDIUM
28 27 Construction/Architecture Hero-Centric + Feature-Rich Minimalism + 3D & Hyperrealism Grey (#4A4A4A) + Orange (safety) + Blueprint Blue Professional + Bold typography 3D model viewer + Timeline animations {"must_have": "project-portfolio", "if_team_collaboration": "add-real-time-updates"} 2D-only layouts + Poor image quality + AI purple/pink gradients HIGH
29 28 Automotive/Car Dealership Hero-Centric + Feature-Rich Motion-Driven + 3D & Hyperrealism Brand colors + Metallic + Dark/Light Bold + Confident typography 360 product view + Configurator animations {"must_have": "vehicle-comparison", "must_have": "financing-calculator"} Static product pages + Poor UX HIGH
30 29 Photography Studio Storytelling-Driven + Hero-Centric Motion-Driven + Minimalism Black + White + Minimal accent Elegant + Minimal typography Full-bleed gallery + Before/after reveal {"must_have": "portfolio-showcase", "if_booking": "add-calendar-system"} Heavy text + Poor image showcase HIGH
31 30 Coworking Space Hero-Centric + Feature-Rich Vibrant & Block-based + Glassmorphism Energetic colors + Wood tones + Brand Modern + Engaging typography Space tour video + Amenity reveal animations {"must_have": "virtual-tour", "must_have": "booking-system"} Outdated photos + Confusing layout MEDIUM
32 31 Cleaning Service Conversion-Optimized + Trust Soft UI Evolution + Flat Design Fresh Blue (#00B4D8) + Clean White + Green Friendly + Clear typography Before/after gallery + Service package reveal {"must_have": "price-transparency", "must_have": "trust-badges"} Poor before/after imagery + Hidden pricing HIGH
33 32 Home Services Conversion-Optimized + Trust Flat Design + Trust & Authority Trust Blue + Safety Orange + Grey Professional + Clear typography Emergency contact highlight + Service menu animations {"must_have": "emergency-contact", "must_have": "certifications-display"} Hidden contact info + No certifications HIGH
34 33 Childcare/Daycare Social Proof-Focused + Trust Claymorphism + Vibrant & Block-based Playful pastels + Safe colors + Warm Friendly + Playful typography Parent portal animations + Activity gallery reveal {"must_have": "parent-communication", "must_have": "safety-certifications"} Generic design + Hidden safety info HIGH
35 34 Senior Care/Elderly Trust & Authority + Accessible Accessible & Ethical + Soft UI Evolution Calm Blue + Warm neutrals + Large text Large + Clear typography (18px+) Large touch targets + Clear navigation {"must_have": "wcag-aaa", "must_have": "family-portal"} Small text + Complex navigation + AI purple/pink gradients HIGH
36 35 Medical Clinic Trust & Authority + Conversion Accessible & Ethical + Minimalism Medical Blue (#0077B6) + Trust White Professional + Readable typography Online booking flow + Doctor profile reveals {"must_have": "appointment-booking", "must_have": "insurance-info"} Outdated interface + Confusing booking + AI purple/pink gradients HIGH
37 36 Pharmacy/Drug Store Conversion-Optimized + Trust Flat Design + Accessible & Ethical Pharmacy Green + Trust Blue + Clean White Clear + Functional typography Prescription upload flow + Refill reminders {"must_have": "prescription-management", "must_have": "drug-interaction-warnings"} Confusing layout + Privacy concerns + AI purple/pink gradients HIGH
38 37 Dental Practice Social Proof-Focused + Conversion Soft UI Evolution + Minimalism Fresh Blue + White + Smile Yellow Friendly + Professional typography Before/after gallery + Patient testimonial carousel {"must_have": "before-after-gallery", "must_have": "appointment-system"} Poor imagery + No testimonials HIGH
39 38 Veterinary Clinic Social Proof-Focused + Trust Claymorphism + Accessible & Ethical Caring Blue + Pet colors + Warm Friendly + Welcoming typography Pet profile management + Service animations {"must_have": "pet-portal", "must_have": "emergency-contact"} Generic design + Hidden services MEDIUM
40 39 News/Media Platform Hero-Centric + Feature-Rich Minimalism + Flat Design Brand colors + High contrast Clear + Readable typography Breaking news badge + Article reveal animations {"must_have": "mobile-first-reading", "must_have": "category-navigation"} Cluttered layout + Slow loading HIGH
41 40 Legal Services Trust & Authority + Minimal Trust & Authority + Minimalism Navy Blue (#1E3A5F) + Gold + White Professional + Authoritative typography Practice area reveal + Attorney profile animations {"must_have": "case-results", "must_have": "credential-display"} Outdated design + Hidden credentials + AI purple/pink gradients HIGH
42 41 Beauty/Spa/Wellness Service Hero-Centric + Social Proof Soft UI Evolution + Neumorphism Soft pastels (Pink Sage Cream) + Gold accents Elegant + Calming typography Soft shadows + Smooth transitions (200-300ms) + Gentle hover {"must_have": "booking-system", "must_have": "before-after-gallery", "if_luxury": "add-gold-accents"} Bright neon colors + Harsh animations + Dark mode HIGH
43 42 Service Landing Page Hero-Centric + Trust & Authority Minimalism + Social Proof-Focused Brand primary + Trust colors Professional + Clear typography Testimonial carousel + CTA hover (200ms) {"must_have": "social-proof", "must_have": "clear-cta"} Complex navigation + Hidden contact info HIGH
44 43 B2B Service Feature-Rich Showcase + Trust Trust & Authority + Minimalism Professional blue + Neutral grey Formal + Clear typography Section transitions + Feature reveals {"must_have": "case-studies", "must_have": "roi-messaging"} Playful design + Hidden credentials + AI purple/pink gradients HIGH
45 44 Financial Dashboard Data-Dense Dashboard Dark Mode (OLED) + Data-Dense Dark bg + Red/Green alerts + Trust blue Clear + Readable typography Real-time number animations + Alert pulse {"must_have": "real-time-updates", "must_have": "high-contrast"} Light mode default + Slow rendering HIGH
46 45 Analytics Dashboard Data-Dense + Drill-Down Data-Dense + Heat Map Cool→Hot gradients + Neutral grey Clear + Functional typography Hover tooltips + Chart zoom + Filter animations {"must_have": "data-export", "if_large_dataset": "virtualize-lists"} Ornate design + No filtering HIGH
47 46 Productivity Tool Interactive Demo + Feature-Rich Flat Design + Micro-interactions Clear hierarchy + Functional colors Clean + Efficient typography Quick actions (150ms) + Task animations {"must_have": "keyboard-shortcuts", "if_collaboration": "add-real-time-cursors"} Complex onboarding + Slow performance HIGH
48 47 Design System/Component Library Feature-Rich + Documentation Minimalism + Accessible & Ethical Clear hierarchy + Code-like structure Monospace + Clear typography Code copy animations + Component previews {"must_have": "search", "must_have": "code-examples"} Poor documentation + No live preview HIGH
49 48 AI/Chatbot Platform Interactive Demo + Minimal AI-Native UI + Minimalism Neutral + AI Purple (#6366F1) Modern + Clear typography Streaming text + Typing indicators + Fade-in {"must_have": "conversational-ui", "must_have": "context-awareness"} Heavy chrome + Slow response feedback HIGH
50 49 NFT/Web3 Platform Feature-Rich Showcase Cyberpunk UI + Glassmorphism Dark + Neon + Gold (#FFD700) Bold + Modern typography Wallet connect animations + Transaction feedback {"must_have": "wallet-integration", "must_have": "gas-fees-display"} Light mode default + No transaction status HIGH
51 50 Creator Economy Platform Social Proof + Feature-Rich Vibrant & Block-based + Bento Box Grid Vibrant + Brand colors Modern + Bold typography Engagement counter animations + Profile reveals {"must_have": "creator-profiles", "must_have": "monetization-display"} Generic layout + Hidden earnings MEDIUM
52 51 Sustainability/ESG Platform Trust & Authority + Data Organic Biophilic + Minimalism Green (#228B22) + Earth tones Clear + Informative typography Progress indicators + Impact animations {"must_have": "data-transparency", "must_have": "certification-badges"} Greenwashing visuals + No data HIGH
53 52 Remote Work/Collaboration Feature-Rich + Real-Time Soft UI Evolution + Minimalism Calm Blue + Neutral grey Clean + Readable typography Real-time presence indicators + Notification badges {"must_have": "status-indicators", "must_have": "video-integration"} Cluttered interface + No presence HIGH
54 53 Pet Tech App Storytelling + Feature-Rich Claymorphism + Vibrant & Block-based Playful + Warm colors Friendly + Playful typography Pet profile animations + Health tracking charts {"must_have": "pet-profiles", "if_health": "add-vet-integration"} Generic design + No personality MEDIUM
55 54 Smart Home/IoT Dashboard Real-Time Monitoring Glassmorphism + Dark Mode (OLED) Dark + Status indicator colors Clear + Functional typography Device status pulse + Quick action animations {"must_have": "real-time-controls", "must_have": "energy-monitoring"} Slow updates + No automation HIGH
56 55 EV/Charging Ecosystem Hero-Centric + Feature-Rich Minimalism + Aurora UI Electric Blue (#009CD1) + Green Modern + Clear typography Range estimation animations + Map interactions {"must_have": "charging-map", "must_have": "range-calculator"} Poor map UX + Hidden costs HIGH
57 56 Subscription Box Service Feature-Rich + Conversion Vibrant & Block-based + Motion-Driven Brand + Excitement colors Engaging + Clear typography Unboxing reveal animations + Product carousel {"must_have": "personalization-quiz", "must_have": "subscription-management"} Confusing pricing + No unboxing preview HIGH
58 57 Podcast Platform Storytelling + Feature-Rich Dark Mode (OLED) + Minimalism Dark + Audio waveform accents Modern + Clear typography Waveform visualizations + Episode transitions {"must_have": "audio-player-ux", "must_have": "episode-discovery"} Poor audio player + Cluttered layout HIGH
59 58 Dating App Social Proof + Feature-Rich Vibrant & Block-based + Motion-Driven Warm + Romantic (Pink/Red gradients) Modern + Friendly typography Profile card swipe + Match animations {"must_have": "profile-cards", "must_have": "safety-features"} Generic profiles + No safety HIGH
60 59 Micro-Credentials/Badges Trust & Authority + Feature Minimalism + Flat Design Trust Blue + Gold (#FFD700) Professional + Clear typography Badge reveal animations + Progress tracking {"must_have": "credential-verification", "must_have": "progress-display"} No verification + Hidden progress MEDIUM
61 60 Knowledge Base/Documentation FAQ + Minimal Minimalism + Accessible & Ethical Clean hierarchy + Minimal color Clear + Readable typography Search highlight + Smooth scrolling {"must_have": "search-first", "must_have": "version-switching"} Poor navigation + No search HIGH
62 61 Hyperlocal Services Conversion + Feature-Rich Minimalism + Vibrant & Block-based Location markers + Trust colors Clear + Functional typography Map hover + Provider card reveals {"must_have": "map-integration", "must_have": "booking-system"} No map + Hidden reviews HIGH
63 62 Luxury/Premium Brand Storytelling + Feature-Rich Liquid Glass + Glassmorphism Black + Gold (#FFD700) + White Elegant + Refined typography Slow parallax + Premium reveals (400-600ms) {"must_have": "high-quality-imagery", "must_have": "storytelling"} Cheap visuals + Fast animations HIGH
64 63 Fitness/Gym App Feature-Rich + Data Vibrant & Block-based + Dark Mode (OLED) Energetic (Orange #FF6B35) + Dark bg Bold + Motivational typography Progress ring animations + Achievement unlocks {"must_have": "progress-tracking", "must_have": "workout-plans"} Static design + No gamification HIGH
65 64 Hotel/Hospitality Hero-Centric + Social Proof Liquid Glass + Minimalism Warm neutrals + Gold (#D4AF37) Elegant + Welcoming typography Room gallery + Amenity reveals {"must_have": "room-booking", "must_have": "virtual-tour"} Poor photos + Complex booking HIGH
66 65 Wedding/Event Planning Storytelling + Social Proof Soft UI Evolution + Aurora UI Soft Pink (#FFD6E0) + Gold + Cream Elegant + Romantic typography Gallery reveals + Timeline animations {"must_have": "portfolio-gallery", "must_have": "planning-tools"} Generic templates + No portfolio HIGH
67 66 Insurance Platform Conversion + Trust Trust & Authority + Flat Design Trust Blue (#0066CC) + Green + Neutral Clear + Professional typography Quote calculator animations + Policy comparison {"must_have": "quote-calculator", "must_have": "policy-comparison"} Confusing pricing + No trust signals + AI purple/pink gradients HIGH
68 67 Banking/Traditional Finance Trust & Authority + Feature Minimalism + Accessible & Ethical Navy (#0A1628) + Trust Blue + Gold Professional + Trustworthy typography Smooth number animations + Security indicators {"must_have": "security-first", "must_have": "accessibility"} Playful design + Poor security UX + AI purple/pink gradients HIGH
69 68 Online Course/E-learning Feature-Rich + Social Proof Claymorphism + Vibrant & Block-based Vibrant learning colors + Progress green Friendly + Engaging typography Progress bar animations + Certificate reveals {"must_have": "progress-tracking", "must_have": "video-player"} Boring design + No gamification HIGH
70 69 Non-profit/Charity Storytelling + Trust Accessible & Ethical + Organic Biophilic Cause-related colors + Trust + Warm Heartfelt + Readable typography Impact counter animations + Story reveals {"must_have": "impact-stories", "must_have": "donation-transparency"} No impact data + Hidden financials HIGH
71 70 Florist/Plant Shop Hero-Centric + Conversion Organic Biophilic + Vibrant & Block-based Natural Green + Floral pinks/purples Elegant + Natural typography Product reveal + Seasonal transitions {"must_have": "delivery-scheduling", "must_have": "care-guides"} Poor imagery + No seasonal content MEDIUM
72 71 Bakery/Cafe Hero-Centric + Conversion Vibrant & Block-based + Soft UI Evolution Warm Brown + Cream + Appetizing accents Warm + Inviting typography Menu hover + Order animations {"must_have": "menu-display", "must_have": "online-ordering"} Poor food photos + Hidden hours HIGH
73 72 Coffee Shop Hero-Centric + Minimal Minimalism + Organic Biophilic Coffee Brown (#6F4E37) + Cream + Warm Cozy + Clean typography Menu transitions + Loyalty animations {"must_have": "menu", "if_loyalty": "add-rewards-system"} Generic design + No atmosphere MEDIUM
74 73 Brewery/Winery Storytelling + Hero-Centric Motion-Driven + Storytelling-Driven Deep amber/burgundy + Gold + Craft Artisanal + Heritage typography Tasting note reveals + Heritage timeline {"must_have": "product-showcase", "must_have": "story-heritage"} Generic product pages + No story HIGH
75 74 Airline Conversion + Feature-Rich Minimalism + Glassmorphism Sky Blue + Brand colors + Trust Clear + Professional typography Flight search animations + Boarding pass reveals {"must_have": "flight-search", "must_have": "mobile-first"} Complex booking + Poor mobile HIGH
76 75 Magazine/Blog Storytelling + Hero-Centric Swiss Modernism 2.0 + Motion-Driven Editorial colors + Brand + Clean white Editorial + Elegant typography Article transitions + Category reveals {"must_have": "article-showcase", "must_have": "newsletter-signup"} Poor typography + Slow loading HIGH
77 76 Freelancer Platform Feature-Rich + Conversion Flat Design + Minimalism Professional Blue + Success Green Clear + Professional typography Skill match animations + Review reveals {"must_have": "portfolio-display", "must_have": "skill-matching"} Poor profiles + No reviews HIGH
78 77 Consulting Firm Trust & Authority + Minimal Trust & Authority + Minimalism Navy + Gold + Professional grey Authoritative + Clear typography Case study reveals + Team profiles {"must_have": "case-studies", "must_have": "thought-leadership"} Generic content + No credentials + AI purple/pink gradients HIGH
79 78 Marketing Agency Storytelling + Feature-Rich Brutalism + Motion-Driven Bold brand colors + Creative freedom Bold + Expressive typography Portfolio reveals + Results animations {"must_have": "portfolio", "must_have": "results-metrics"} Boring design + Hidden work HIGH
80 79 Event Management Hero-Centric + Feature-Rich Vibrant & Block-based + Motion-Driven Event theme colors + Excitement accents Bold + Engaging typography Countdown timer + Registration flow {"must_have": "registration", "must_have": "agenda-display"} Confusing registration + No countdown HIGH
81 80 Conference/Webinar Platform Feature-Rich + Conversion Glassmorphism + Minimalism Professional Blue + Video accent Professional + Clear typography Live stream integration + Agenda transitions {"must_have": "registration", "must_have": "speaker-profiles"} Poor video UX + No networking HIGH
82 81 Membership/Community Social Proof + Conversion Vibrant & Block-based + Soft UI Evolution Community brand colors + Engagement Friendly + Engaging typography Member counter + Benefit reveals {"must_have": "member-benefits", "must_have": "pricing-tiers"} Hidden benefits + No community proof HIGH
83 82 Newsletter Platform Minimal + Conversion Minimalism + Flat Design Brand primary + Clean white + CTA Clean + Readable typography Subscribe form + Archive reveals {"must_have": "subscribe-form", "must_have": "sample-content"} Complex signup + No preview MEDIUM
84 83 Digital Products/Downloads Feature-Rich + Conversion Vibrant & Block-based + Motion-Driven Product colors + Brand + Success green Modern + Clear typography Product preview + Instant delivery animations {"must_have": "product-preview", "must_have": "instant-delivery"} No preview + Slow delivery HIGH
85 84 Church/Religious Organization Hero-Centric + Social Proof Accessible & Ethical + Soft UI Evolution Warm Gold + Deep Purple/Blue + White Welcoming + Clear typography Service time highlights + Event calendar {"must_have": "service-times", "must_have": "community-events"} Outdated design + Hidden info MEDIUM
86 85 Sports Team/Club Hero-Centric + Feature-Rich Vibrant & Block-based + Motion-Driven Team colors + Energetic accents Bold + Impactful typography Score animations + Schedule reveals {"must_have": "schedule", "must_have": "roster"} Static content + Poor fan engagement HIGH
87 86 Museum/Gallery Storytelling + Feature-Rich Minimalism + Motion-Driven Art-appropriate neutrals + Exhibition accents Elegant + Minimal typography Virtual tour + Collection reveals {"must_have": "virtual-tour", "must_have": "exhibition-info"} Cluttered layout + No online access HIGH
88 87 Theater/Cinema Hero-Centric + Conversion Dark Mode (OLED) + Motion-Driven Dark + Spotlight accents + Gold Dramatic + Bold typography Seat selection + Trailer reveals {"must_have": "showtimes", "must_have": "seat-selection"} Poor booking UX + No trailers HIGH
89 88 Language Learning App Feature-Rich + Social Proof Claymorphism + Vibrant & Block-based Playful colors + Progress indicators Friendly + Clear typography Progress animations + Achievement unlocks {"must_have": "progress-tracking", "must_have": "gamification"} Boring design + No motivation HIGH
90 89 Coding Bootcamp Feature-Rich + Social Proof Dark Mode (OLED) + Minimalism Code editor colors + Brand + Success Technical + Clear typography Terminal animations + Career outcome reveals {"must_have": "curriculum", "must_have": "career-outcomes"} Light mode only + Hidden results HIGH
91 90 Cybersecurity Platform Trust & Authority + Real-Time Cyberpunk UI + Dark Mode (OLED) Matrix Green (#00FF00) + Deep Black Technical + Clear typography Threat visualization + Alert animations {"must_have": "real-time-monitoring", "must_have": "threat-display"} Light mode + Poor data viz HIGH
92 91 Developer Tool/IDE Minimal + Documentation Dark Mode (OLED) + Minimalism Dark syntax theme + Blue focus Monospace + Functional typography Syntax highlighting + Command palette {"must_have": "keyboard-shortcuts", "must_have": "documentation"} Light mode default + Slow performance HIGH
93 92 Biotech/Life Sciences Storytelling + Data Glassmorphism + Clean Science Sterile White + DNA Blue + Life Green Scientific + Clear typography Data visualization + Research reveals {"must_have": "data-accuracy", "must_have": "clean-aesthetic"} Cluttered data + Poor credibility HIGH
94 93 Space Tech/Aerospace Immersive + Feature-Rich Holographic/HUD + Dark Mode Deep Space Black + Star White + Metallic Futuristic + Precise typography Telemetry animations + 3D renders {"must_have": "high-tech-feel", "must_have": "precision-data"} Generic design + No immersion HIGH
95 94 Architecture/Interior Portfolio + Hero-Centric Exaggerated Minimalism + High Imagery Monochrome + Gold Accent + High Imagery Architectural + Elegant typography Project gallery + Blueprint reveals {"must_have": "high-res-images", "must_have": "project-portfolio"} Poor imagery + Cluttered layout HIGH
96 95 Quantum Computing Immersive + Interactive Holographic/HUD + Dark Mode Quantum Blue (#00FFFF) + Deep Black Futuristic + Scientific typography Probability visualizations + Qubit state animations {"must_have": "complexity-visualization", "must_have": "scientific-credibility"} Generic tech design + No viz HIGH
97 96 Biohacking/Longevity App Data-Dense + Storytelling Biomimetic/Organic 2.0 + Minimalism Cellular Pink/Red + DNA Blue + White Scientific + Clear typography Biological data viz + Progress animations {"must_have": "data-privacy", "must_have": "scientific-credibility"} Generic health app + No privacy HIGH
98 97 Autonomous Drone Fleet Real-Time + Feature-Rich HUD/Sci-Fi FUI + Real-Time Tactical Green + Alert Red + Map Dark Technical + Functional typography Telemetry animations + 3D spatial awareness {"must_have": "real-time-telemetry", "must_have": "safety-alerts"} Slow updates + Poor spatial viz HIGH
99 98 Generative Art Platform Showcase + Feature-Rich Minimalism + Gen Z Chaos Neutral (#F5F5F5) + User Content Minimal + Content-focused typography Gallery masonry + Minting animations {"must_have": "fast-loading", "must_have": "creator-attribution"} Heavy chrome + Slow loading HIGH
100 99 Spatial Computing OS Immersive + Interactive Spatial UI (VisionOS) + Glassmorphism Frosted Glass + System Colors + Depth Spatial + Readable typography Depth hierarchy + Gaze interactions {"must_have": "depth-hierarchy", "must_have": "environment-awareness"} 2D design + No spatial depth HIGH
101 100 Sustainable Energy/Climate Data + Trust Organic Biophilic + E-Ink/Paper Earth Green + Sky Blue + Solar Yellow Clear + Informative typography Impact viz + Progress animations {"must_have": "data-transparency", "must_have": "impact-visualization"} Greenwashing + No real data HIGH

View File

@@ -0,0 +1,31 @@
No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
1,Accessibility,Icon Button Labels,icon button aria-label,Web,Icon-only buttons must have accessible names,Add aria-label to icon buttons,Icon button without label,"<button aria-label='Close'><XIcon /></button>","<button><XIcon /></button>",Critical
2,Accessibility,Form Control Labels,form input label aria,Web,All form controls need labels or aria-label,Use label element or aria-label,Input without accessible name,"<label for='email'>Email</label><input id='email' />","<input placeholder='Email' />",Critical
3,Accessibility,Keyboard Handlers,keyboard onclick onkeydown,Web,Interactive elements must support keyboard interaction,Add onKeyDown alongside onClick,Click-only interaction,"<div onClick={fn} onKeyDown={fn} tabIndex={0}>","<div onClick={fn}>",High
4,Accessibility,Semantic HTML,semantic button a label,Web,Use semantic HTML before ARIA attributes,Use button/a/label elements,Div with role attribute,"<button onClick={fn}>Submit</button>","<div role='button' onClick={fn}>Submit</div>",High
5,Accessibility,Aria Live,aria-live polite async,Web,Async updates need aria-live for screen readers,Add aria-live='polite' for dynamic content,Silent async updates,"<div aria-live='polite'>{status}</div>","<div>{status}</div> // no announcement",Medium
6,Accessibility,Decorative Icons,aria-hidden decorative icon,Web,Decorative icons should be hidden from screen readers,Add aria-hidden='true' to decorative icons,Decorative icon announced,"<Icon aria-hidden='true' />","<Icon /> // announced as 'image'",Medium
7,Focus,Visible Focus States,focus-visible outline ring,Web,All interactive elements need visible focus states,Use :focus-visible with ring/outline,No focus indication,"focus-visible:ring-2 focus-visible:ring-blue-500","outline-none // no replacement",Critical
8,Focus,Never Remove Outline,outline-none focus replacement,Web,Never remove outline without providing replacement,Replace outline with visible alternative,Remove outline completely,"focus:outline-none focus:ring-2","focus:outline-none // nothing else",Critical
9,Focus,Checkbox Radio Hit Target,checkbox radio label target,Web,Checkbox/radio must share hit target with label,Wrap input and label together,Separate tiny checkbox,"<label class='flex gap-2'><input type='checkbox' /><span>Option</span></label>","<input type='checkbox' id='x' /><label for='x'>Option</label>",Medium
10,Forms,Autocomplete Attribute,autocomplete input form,Web,Inputs need autocomplete attribute for autofill,Add appropriate autocomplete value,Missing autocomplete,"<input autocomplete='email' type='email' />","<input type='email' />",High
11,Forms,Semantic Input Types,input type email tel url,Web,Use semantic input type attributes,Use email/tel/url/number types,text type for everything,"<input type='email' />","<input type='text' /> // for email",Medium
12,Forms,Never Block Paste,paste onpaste password,Web,Never prevent paste functionality,Allow paste on all inputs,Block paste on password/code,"<input type='password' />","<input onPaste={e => e.preventDefault()} />",High
13,Forms,Spellcheck Disable,spellcheck email code,Web,Disable spellcheck on emails and codes,Set spellcheck='false' on codes,Spellcheck on technical input,"<input spellCheck='false' type='email' />","<input type='email' /> // red squiggles",Low
14,Forms,Submit Button Enabled,submit button disabled loading,Web,Keep submit enabled and show spinner during requests,Show loading spinner keep enabled,Disable button during submit,"<button>{loading ? <Spinner /> : 'Submit'}</button>","<button disabled={loading}>Submit</button>",Medium
15,Forms,Inline Errors,error message inline focus,Web,Show error messages inline near the problem field,Inline error with focus on first error,Single error at top,"<input /><span class='text-red-500'>{error}</span>","<div class='error'>{allErrors}</div> // at top",High
16,Performance,Virtualize Lists,virtualize list 50 items,Web,Virtualize lists exceeding 50 items,Use virtual list for large datasets,Render all items,"<VirtualList items={items} />","items.map(item => <Item />)",High
17,Performance,Avoid Layout Reads,layout read render getboundingclientrect,Web,Avoid layout reads during render phase,Read layout in effects or callbacks,getBoundingClientRect in render,"useEffect(() => { el.getBoundingClientRect() })","const rect = el.getBoundingClientRect() // in render",Medium
18,Performance,Batch DOM Operations,batch dom write read,Web,Group DOM operations to minimize reflows,Batch writes then reads,Interleave reads and writes,"writes.forEach(w => w()); reads.forEach(r => r())","write(); read(); write(); read(); // thrashing",Medium
19,Performance,Preconnect CDN,preconnect link cdn,Web,Add preconnect links for CDN domains,Preconnect to known domains,"<link rel='preconnect' href='https://cdn.example.com' />","// no preconnect hint",Low
20,Performance,Lazy Load Images,lazy loading image below-fold,Web,Lazy-load images below the fold,Use loading='lazy' for below-fold images,Load all images eagerly,"<img loading='lazy' src='...' />","<img src='...' /> // above fold only",Medium
21,State,URL Reflects State,url state query params,Web,URL should reflect current UI state,Sync filters/tabs/pagination to URL,State only in memory,"?tab=settings&page=2","useState only // lost on refresh",High
22,State,Deep Linking,deep link stateful component,Web,Stateful components should support deep-linking,Enable sharing current view via URL,No shareable state,"router.push({ query: { ...filters } })","setFilters(f) // not in URL",Medium
23,State,Confirm Destructive Actions,confirm destructive delete modal,Web,Destructive actions require confirmation,Show confirmation dialog before delete,Delete without confirmation,"if (confirm('Delete?')) delete()","onClick={delete} // no confirmation",High
24,Typography,Proper Unicode,unicode ellipsis quotes,Web,Use proper Unicode characters,Use ... curly quotes proper dashes,ASCII approximations,"'Hello...' with proper ellipsis","'Hello...' with three dots",Low
25,Typography,Text Overflow,truncate line-clamp overflow,Web,Handle text overflow properly,Use truncate/line-clamp/break-words,Text overflows container,"<p class='truncate'>Long text...</p>","<p>Long text...</p> // overflows",Medium
26,Typography,Non-Breaking Spaces,nbsp unit brand,Web,Use non-breaking spaces for units and brand names,Use &nbsp; between number and unit,"10&nbsp;kg or Next.js&nbsp;14","10 kg // may wrap",Low
27,Anti-Pattern,No Zoom Disable,viewport zoom disable,Web,Never disable zoom in viewport meta,Allow user zoom,"<meta name='viewport' content='width=device-width'>","<meta name='viewport' content='maximum-scale=1'>",Critical
28,Anti-Pattern,No Transition All,transition all specific,Web,Avoid transition: all - specify properties,Transition specific properties,transition: all,"transition-colors duration-200","transition-all duration-200",Medium
29,Anti-Pattern,Outline Replacement,outline-none ring focus,Web,Never use outline-none without replacement,Provide visible focus replacement,Remove outline with nothing,"focus:outline-none focus:ring-2 focus:ring-blue-500","focus:outline-none // alone",Critical
30,Anti-Pattern,No Hardcoded Dates,date format intl locale,Web,Use Intl for date/number formatting,Use Intl.DateTimeFormat,Hardcoded date format,"new Intl.DateTimeFormat('en').format(date)","date.toLocaleDateString() // or manual format",Medium
1 No Category Issue Keywords Platform Description Do Don't Code Example Good Code Example Bad Severity
2 1 Accessibility Icon Button Labels icon button aria-label Web Icon-only buttons must have accessible names Add aria-label to icon buttons Icon button without label <button aria-label='Close'><XIcon /></button> <button><XIcon /></button> Critical
3 2 Accessibility Form Control Labels form input label aria Web All form controls need labels or aria-label Use label element or aria-label Input without accessible name <label for='email'>Email</label><input id='email' /> <input placeholder='Email' /> Critical
4 3 Accessibility Keyboard Handlers keyboard onclick onkeydown Web Interactive elements must support keyboard interaction Add onKeyDown alongside onClick Click-only interaction <div onClick={fn} onKeyDown={fn} tabIndex={0}> <div onClick={fn}> High
5 4 Accessibility Semantic HTML semantic button a label Web Use semantic HTML before ARIA attributes Use button/a/label elements Div with role attribute <button onClick={fn}>Submit</button> <div role='button' onClick={fn}>Submit</div> High
6 5 Accessibility Aria Live aria-live polite async Web Async updates need aria-live for screen readers Add aria-live='polite' for dynamic content Silent async updates <div aria-live='polite'>{status}</div> <div>{status}</div> // no announcement Medium
7 6 Accessibility Decorative Icons aria-hidden decorative icon Web Decorative icons should be hidden from screen readers Add aria-hidden='true' to decorative icons Decorative icon announced <Icon aria-hidden='true' /> <Icon /> // announced as 'image' Medium
8 7 Focus Visible Focus States focus-visible outline ring Web All interactive elements need visible focus states Use :focus-visible with ring/outline No focus indication focus-visible:ring-2 focus-visible:ring-blue-500 outline-none // no replacement Critical
9 8 Focus Never Remove Outline outline-none focus replacement Web Never remove outline without providing replacement Replace outline with visible alternative Remove outline completely focus:outline-none focus:ring-2 focus:outline-none // nothing else Critical
10 9 Focus Checkbox Radio Hit Target checkbox radio label target Web Checkbox/radio must share hit target with label Wrap input and label together Separate tiny checkbox <label class='flex gap-2'><input type='checkbox' /><span>Option</span></label> <input type='checkbox' id='x' /><label for='x'>Option</label> Medium
11 10 Forms Autocomplete Attribute autocomplete input form Web Inputs need autocomplete attribute for autofill Add appropriate autocomplete value Missing autocomplete <input autocomplete='email' type='email' /> <input type='email' /> High
12 11 Forms Semantic Input Types input type email tel url Web Use semantic input type attributes Use email/tel/url/number types text type for everything <input type='email' /> <input type='text' /> // for email Medium
13 12 Forms Never Block Paste paste onpaste password Web Never prevent paste functionality Allow paste on all inputs Block paste on password/code <input type='password' /> <input onPaste={e => e.preventDefault()} /> High
14 13 Forms Spellcheck Disable spellcheck email code Web Disable spellcheck on emails and codes Set spellcheck='false' on codes Spellcheck on technical input <input spellCheck='false' type='email' /> <input type='email' /> // red squiggles Low
15 14 Forms Submit Button Enabled submit button disabled loading Web Keep submit enabled and show spinner during requests Show loading spinner keep enabled Disable button during submit <button>{loading ? <Spinner /> : 'Submit'}</button> <button disabled={loading}>Submit</button> Medium
16 15 Forms Inline Errors error message inline focus Web Show error messages inline near the problem field Inline error with focus on first error Single error at top <input /><span class='text-red-500'>{error}</span> <div class='error'>{allErrors}</div> // at top High
17 16 Performance Virtualize Lists virtualize list 50 items Web Virtualize lists exceeding 50 items Use virtual list for large datasets Render all items <VirtualList items={items} /> items.map(item => <Item />) High
18 17 Performance Avoid Layout Reads layout read render getboundingclientrect Web Avoid layout reads during render phase Read layout in effects or callbacks getBoundingClientRect in render useEffect(() => { el.getBoundingClientRect() }) const rect = el.getBoundingClientRect() // in render Medium
19 18 Performance Batch DOM Operations batch dom write read Web Group DOM operations to minimize reflows Batch writes then reads Interleave reads and writes writes.forEach(w => w()); reads.forEach(r => r()) write(); read(); write(); read(); // thrashing Medium
20 19 Performance Preconnect CDN preconnect link cdn Web Add preconnect links for CDN domains Preconnect to known domains <link rel='preconnect' href='https://cdn.example.com' /> // no preconnect hint Low
21 20 Performance Lazy Load Images lazy loading image below-fold Web Lazy-load images below the fold Use loading='lazy' for below-fold images Load all images eagerly <img loading='lazy' src='...' /> <img src='...' /> // above fold only Medium
22 21 State URL Reflects State url state query params Web URL should reflect current UI state Sync filters/tabs/pagination to URL State only in memory ?tab=settings&page=2 useState only // lost on refresh High
23 22 State Deep Linking deep link stateful component Web Stateful components should support deep-linking Enable sharing current view via URL No shareable state router.push({ query: { ...filters } }) setFilters(f) // not in URL Medium
24 23 State Confirm Destructive Actions confirm destructive delete modal Web Destructive actions require confirmation Show confirmation dialog before delete Delete without confirmation if (confirm('Delete?')) delete() onClick={delete} // no confirmation High
25 24 Typography Proper Unicode unicode ellipsis quotes Web Use proper Unicode characters Use ... curly quotes proper dashes ASCII approximations 'Hello...' with proper ellipsis 'Hello...' with three dots Low
26 25 Typography Text Overflow truncate line-clamp overflow Web Handle text overflow properly Use truncate/line-clamp/break-words Text overflows container <p class='truncate'>Long text...</p> <p>Long text...</p> // overflows Medium
27 26 Typography Non-Breaking Spaces nbsp unit brand Web Use non-breaking spaces for units and brand names Use &nbsp; between number and unit 10&nbsp;kg or Next.js&nbsp;14 10 kg // may wrap Low
28 27 Anti-Pattern No Zoom Disable viewport zoom disable Web Never disable zoom in viewport meta Allow user zoom <meta name='viewport' content='width=device-width'> <meta name='viewport' content='maximum-scale=1'> Critical
29 28 Anti-Pattern No Transition All transition all specific Web Avoid transition: all - specify properties Transition specific properties transition: all transition-colors duration-200 transition-all duration-200 Medium
30 29 Anti-Pattern Outline Replacement outline-none ring focus Web Never use outline-none without replacement Provide visible focus replacement Remove outline with nothing focus:outline-none focus:ring-2 focus:ring-blue-500 focus:outline-none // alone Critical
31 30 Anti-Pattern No Hardcoded Dates date format intl locale Web Use Intl for date/number formatting Use Intl.DateTimeFormat Hardcoded date format new Intl.DateTimeFormat('en').format(date) date.toLocaleDateString() // or manual format Medium