page-design-guide-mcp 1.0.7 → 1.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/build/data/accessibilityGuidance.d.ts +17 -0
  2. package/build/data/accessibilityGuidance.d.ts.map +1 -0
  3. package/build/data/accessibilityGuidance.js +22 -0
  4. package/build/data/accessibilityGuidance.js.map +1 -0
  5. package/build/data/animationGuidance.d.ts +22 -0
  6. package/build/data/animationGuidance.d.ts.map +1 -0
  7. package/build/data/animationGuidance.js +27 -0
  8. package/build/data/animationGuidance.js.map +1 -0
  9. package/build/data/colorGuidance.d.ts +53 -0
  10. package/build/data/colorGuidance.d.ts.map +1 -0
  11. package/build/data/colorGuidance.js +84 -0
  12. package/build/data/colorGuidance.js.map +1 -0
  13. package/build/data/componentGuidance.d.ts +69 -0
  14. package/build/data/componentGuidance.d.ts.map +1 -0
  15. package/build/data/componentGuidance.js +74 -0
  16. package/build/data/componentGuidance.js.map +1 -0
  17. package/build/data/designPrinciples.d.ts +7 -0
  18. package/build/data/designPrinciples.d.ts.map +1 -0
  19. package/build/data/designPrinciples.js +98 -0
  20. package/build/data/designPrinciples.js.map +1 -0
  21. package/build/data/inspiration.d.ts +45 -0
  22. package/build/data/inspiration.d.ts.map +1 -0
  23. package/build/data/inspiration.js +68 -0
  24. package/build/data/inspiration.js.map +1 -0
  25. package/build/data/layoutPatterns.d.ts +219 -0
  26. package/build/data/layoutPatterns.d.ts.map +1 -0
  27. package/build/data/layoutPatterns.js +84 -0
  28. package/build/data/layoutPatterns.js.map +1 -0
  29. package/build/data/modernPalettes.d.ts +42 -0
  30. package/build/data/modernPalettes.d.ts.map +1 -0
  31. package/build/data/modernPalettes.js +72 -0
  32. package/build/data/modernPalettes.js.map +1 -0
  33. package/build/data/modernTrends.d.ts +134 -0
  34. package/build/data/modernTrends.d.ts.map +1 -0
  35. package/build/data/modernTrends.js +90 -0
  36. package/build/data/modernTrends.js.map +1 -0
  37. package/build/data/responsiveGuidance.d.ts +23 -0
  38. package/build/data/responsiveGuidance.d.ts.map +1 -0
  39. package/build/data/responsiveGuidance.js +24 -0
  40. package/build/data/responsiveGuidance.js.map +1 -0
  41. package/build/data/sectionGuidance.d.ts +163 -0
  42. package/build/data/sectionGuidance.d.ts.map +1 -0
  43. package/build/data/sectionGuidance.js +232 -0
  44. package/build/data/sectionGuidance.js.map +1 -0
  45. package/build/data/typographyGuidance.d.ts +47 -0
  46. package/build/data/typographyGuidance.d.ts.map +1 -0
  47. package/build/data/typographyGuidance.js +54 -0
  48. package/build/data/typographyGuidance.js.map +1 -0
  49. package/build/index.d.ts +3 -0
  50. package/build/index.d.ts.map +1 -0
  51. package/package.json +2 -4
@@ -0,0 +1,17 @@
1
+ export declare const accessibilityGuidance: {
2
+ colorContrast: {
3
+ normalText: string;
4
+ largeText: string;
5
+ uiComponents: string;
6
+ };
7
+ focusStates: {
8
+ requirement: string;
9
+ implementation: string;
10
+ };
11
+ semanticHTML: {
12
+ landmarks: string;
13
+ headings: string;
14
+ };
15
+ bestPractices: string[];
16
+ };
17
+ //# sourceMappingURL=accessibilityGuidance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"accessibilityGuidance.d.ts","sourceRoot":"","sources":["../../src/data/accessibilityGuidance.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;CAmBjC,CAAC"}
@@ -0,0 +1,22 @@
1
+ // Accessibility Guidance
2
+ export const accessibilityGuidance = {
3
+ colorContrast: {
4
+ normalText: "4.5:1 minimum ratio",
5
+ largeText: "3:1 minimum (18px+ or 14px bold)",
6
+ uiComponents: "3:1 for interactive elements"
7
+ },
8
+ focusStates: {
9
+ requirement: "All interactive elements must have visible focus",
10
+ implementation: "Outline or ring, 2-3px, contrasting color"
11
+ },
12
+ semanticHTML: {
13
+ landmarks: "Use header, main, nav, footer, section, article",
14
+ headings: "Proper hierarchy (h1 > h2 > h3), no skipping levels"
15
+ },
16
+ bestPractices: [
17
+ "Test with keyboard navigation",
18
+ "Don't rely on color alone to convey information",
19
+ "Provide alt text for informative images"
20
+ ]
21
+ };
22
+ //# sourceMappingURL=accessibilityGuidance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"accessibilityGuidance.js","sourceRoot":"","sources":["../../src/data/accessibilityGuidance.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,aAAa,EAAE;QACX,UAAU,EAAE,qBAAqB;QACjC,SAAS,EAAE,kCAAkC;QAC7C,YAAY,EAAE,8BAA8B;KAC/C;IACD,WAAW,EAAE;QACT,WAAW,EAAE,kDAAkD;QAC/D,cAAc,EAAE,2CAA2C;KAC9D;IACD,YAAY,EAAE;QACV,SAAS,EAAE,iDAAiD;QAC5D,QAAQ,EAAE,qDAAqD;KAClE;IACD,aAAa,EAAE;QACX,+BAA+B;QAC/B,iDAAiD;QACjD,yCAAyC;KAC5C;CACJ,CAAC"}
@@ -0,0 +1,22 @@
1
+ export declare const animationGuidance: {
2
+ purposes: {
3
+ feedback: string;
4
+ continuity: string;
5
+ attention: string;
6
+ hierarchy: string;
7
+ delight: string;
8
+ };
9
+ timingPrinciples: {
10
+ microInteractions: string;
11
+ smallTransitions: string;
12
+ mediumTransitions: string;
13
+ largeTransitions: string;
14
+ };
15
+ easings: {
16
+ standard: string;
17
+ enter: string;
18
+ exit: string;
19
+ };
20
+ bestPractices: string[];
21
+ };
22
+ //# sourceMappingURL=animationGuidance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"animationGuidance.d.ts","sourceRoot":"","sources":["../../src/data/animationGuidance.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;CAwB7B,CAAC"}
@@ -0,0 +1,27 @@
1
+ // Animation Guidance (Repaired and Completed)
2
+ export const animationGuidance = {
3
+ purposes: {
4
+ feedback: "Confirm user actions (button press, form submit)",
5
+ continuity: "Smooth transitions between states/pages",
6
+ attention: "Draw focus to important elements",
7
+ hierarchy: "Show relationships and depth",
8
+ delight: "Add personality and polish (use sparingly)"
9
+ },
10
+ timingPrinciples: {
11
+ microInteractions: "100-200ms (instant feel)",
12
+ smallTransitions: "200-300ms (noticeable but quick)",
13
+ mediumTransitions: "300-500ms (deliberate movement)",
14
+ largeTransitions: "500-800ms (page loads, complex reveals)"
15
+ },
16
+ easings: {
17
+ standard: "ease-in-out (natural acceleration/deceleration)",
18
+ enter: "ease-out (fast in, slow stop)",
19
+ exit: "ease-in (slow start, fast out)"
20
+ },
21
+ bestPractices: [
22
+ "Respect 'prefers-reduced-motion' media query",
23
+ "Don't animate just for the sake of it",
24
+ "Keep animations fast to avoid feeling sluggish"
25
+ ]
26
+ };
27
+ //# sourceMappingURL=animationGuidance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"animationGuidance.js","sourceRoot":"","sources":["../../src/data/animationGuidance.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,QAAQ,EAAE;QACN,QAAQ,EAAE,kDAAkD;QAC5D,UAAU,EAAE,yCAAyC;QACrD,SAAS,EAAE,kCAAkC;QAC7C,SAAS,EAAE,8BAA8B;QACzC,OAAO,EAAE,4CAA4C;KACxD;IACD,gBAAgB,EAAE;QACd,iBAAiB,EAAE,0BAA0B;QAC7C,gBAAgB,EAAE,kCAAkC;QACpD,iBAAiB,EAAE,iCAAiC;QACpD,gBAAgB,EAAE,yCAAyC;KAC9D;IACD,OAAO,EAAE;QACL,QAAQ,EAAE,iDAAiD;QAC3D,KAAK,EAAE,+BAA+B;QACtC,IAAI,EAAE,gCAAgC;KACzC;IACD,aAAa,EAAE;QACX,8CAA8C;QAC9C,uCAAuC;QACvC,gDAAgD;KACnD;CACJ,CAAC"}
@@ -0,0 +1,53 @@
1
+ export declare const colorGuidance: {
2
+ psychology: {
3
+ blue: {
4
+ associations: string[];
5
+ bestFor: string[];
6
+ avoid: string[];
7
+ };
8
+ green: {
9
+ associations: string[];
10
+ bestFor: string[];
11
+ avoid: string[];
12
+ };
13
+ red: {
14
+ associations: string[];
15
+ bestFor: string[];
16
+ avoid: string[];
17
+ };
18
+ orange: {
19
+ associations: string[];
20
+ bestFor: string[];
21
+ avoid: string[];
22
+ };
23
+ purple: {
24
+ associations: string[];
25
+ bestFor: string[];
26
+ avoid: string[];
27
+ };
28
+ black: {
29
+ associations: string[];
30
+ bestFor: string[];
31
+ avoid: string[];
32
+ };
33
+ white: {
34
+ associations: string[];
35
+ bestFor: string[];
36
+ avoid: string[];
37
+ };
38
+ };
39
+ modernPalettes: {
40
+ name: string;
41
+ primary: string;
42
+ accent: string;
43
+ neutrals: string;
44
+ mood: string;
45
+ }[];
46
+ applicationRules: {
47
+ sixtyThirtyTen: string;
48
+ ctaColors: string;
49
+ textColors: string;
50
+ backgrounds: string;
51
+ };
52
+ };
53
+ //# sourceMappingURL=colorGuidance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"colorGuidance.d.ts","sourceRoot":"","sources":["../../src/data/colorGuidance.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFzB,CAAC"}
@@ -0,0 +1,84 @@
1
+ // Color Psychology and Schemes
2
+ export const colorGuidance = {
3
+ psychology: {
4
+ blue: {
5
+ associations: ["Trust", "Stability", "Professionalism", "Calm", "Security"],
6
+ bestFor: ["Finance", "Healthcare", "Technology", "Corporate", "SaaS"],
7
+ avoid: ["Food (suppresses appetite)", "Urgency-based messaging"]
8
+ },
9
+ green: {
10
+ associations: ["Growth", "Nature", "Health", "Wealth", "Sustainability"],
11
+ bestFor: ["Environmental", "Health/Wellness", "Finance", "Organic products"],
12
+ avoid: ["Luxury brands", "High-energy products"]
13
+ },
14
+ red: {
15
+ associations: ["Energy", "Urgency", "Passion", "Excitement", "Power"],
16
+ bestFor: ["Sales/Clearance", "Food", "Entertainment", "Sports"],
17
+ avoid: ["Healthcare", "Financial (except warnings)", "Relaxation"]
18
+ },
19
+ orange: {
20
+ associations: ["Creativity", "Enthusiasm", "Fun", "Confidence", "Adventure"],
21
+ bestFor: ["Youth brands", "Creative agencies", "Food", "Fitness"],
22
+ avoid: ["Luxury", "Corporate/formal", "Healthcare"]
23
+ },
24
+ purple: {
25
+ associations: ["Luxury", "Creativity", "Wisdom", "Royalty", "Mystery"],
26
+ bestFor: ["Beauty", "Luxury goods", "Creative services", "Spirituality"],
27
+ avoid: ["Budget brands", "Masculine products", "Agriculture"]
28
+ },
29
+ black: {
30
+ associations: ["Elegance", "Power", "Sophistication", "Luxury", "Mystery"],
31
+ bestFor: ["Luxury brands", "Fashion", "Tech", "Premium products"],
32
+ avoid: ["Children's products", "Healthcare", "Budget brands"]
33
+ },
34
+ white: {
35
+ associations: ["Purity", "Simplicity", "Cleanliness", "Modern", "Minimal"],
36
+ bestFor: ["Healthcare", "Tech", "Minimalist brands", "Weddings"],
37
+ avoid: ["Over-reliance can feel sterile or empty"]
38
+ }
39
+ },
40
+ modernPalettes: [
41
+ {
42
+ name: "Professional Trust",
43
+ primary: "Deep blue (#1E40AF to #2563EB)",
44
+ accent: "Amber or teal for CTAs",
45
+ neutrals: "Slate grays",
46
+ mood: "Trustworthy, established, reliable"
47
+ },
48
+ {
49
+ name: "Modern Minimal",
50
+ primary: "Near-black (#0F172A)",
51
+ accent: "Single vibrant color for emphasis",
52
+ neutrals: "Cool grays on white",
53
+ mood: "Clean, sophisticated, focused"
54
+ },
55
+ {
56
+ name: "Warm & Approachable",
57
+ primary: "Coral or warm orange (#F97316)",
58
+ accent: "Complementary teal",
59
+ neutrals: "Warm grays",
60
+ mood: "Friendly, energetic, inviting"
61
+ },
62
+ {
63
+ name: "Nature & Growth",
64
+ primary: "Forest green (#15803D)",
65
+ accent: "Earth tones or gold",
66
+ neutrals: "Warm off-whites",
67
+ mood: "Organic, sustainable, healthy"
68
+ },
69
+ {
70
+ name: "Dark Mode Elegant",
71
+ primary: "Dark gray (#18181B) background",
72
+ accent: "Vibrant purple, blue, or green",
73
+ neutrals: "Gray scale for hierarchy",
74
+ mood: "Modern, tech-forward, sophisticated"
75
+ }
76
+ ],
77
+ applicationRules: {
78
+ sixtyThirtyTen: "60% dominant color (usually background), 30% secondary, 10% accent",
79
+ ctaColors: "CTAs should be the most visually distinct color on the page",
80
+ textColors: "Dark text on light backgrounds, light text on dark. Never pure black (#000) on pure white (#FFF) - too harsh",
81
+ backgrounds: "Slight tints are softer than pure white. #FAFAFA or #F8FAFC feel more refined"
82
+ }
83
+ };
84
+ //# sourceMappingURL=colorGuidance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"colorGuidance.js","sourceRoot":"","sources":["../../src/data/colorGuidance.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,69 @@
1
+ export declare const componentGuidance: {
2
+ buttons: {
3
+ primary: {
4
+ sizing: string;
5
+ fontSize: string;
6
+ borderRadius: string;
7
+ fontWeight: string;
8
+ colors: string;
9
+ hoverEffect: string;
10
+ example: string;
11
+ };
12
+ secondary: {
13
+ style: string;
14
+ example: string;
15
+ };
16
+ modernVariants: string[];
17
+ };
18
+ cards: {
19
+ modern: {
20
+ background: string;
21
+ shadow: string;
22
+ borderRadius: string;
23
+ padding: string;
24
+ border: string;
25
+ hover: string;
26
+ };
27
+ layout: {
28
+ image: string;
29
+ spacing: string;
30
+ cta: string;
31
+ };
32
+ };
33
+ forms: {
34
+ inputs: {
35
+ sizing: string;
36
+ padding: string;
37
+ borderRadius: string;
38
+ border: string;
39
+ fontSize: string;
40
+ background: string;
41
+ };
42
+ labels: {
43
+ position: string;
44
+ fontSize: string;
45
+ fontWeight: string;
46
+ color: string;
47
+ };
48
+ validation: {
49
+ success: string;
50
+ error: string;
51
+ };
52
+ };
53
+ navigation: {
54
+ modern: {
55
+ style: string;
56
+ linkSpacing: string;
57
+ fontSize: string;
58
+ fontWeight: string;
59
+ activeState: string;
60
+ hoverState: string;
61
+ };
62
+ mobile: {
63
+ pattern: string;
64
+ animation: string;
65
+ closeButton: string;
66
+ };
67
+ };
68
+ };
69
+ //# sourceMappingURL=componentGuidance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"componentGuidance.d.ts","sourceRoot":"","sources":["../../src/data/componentGuidance.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuE7B,CAAC"}
@@ -0,0 +1,74 @@
1
+ // Component Design Guidance (NEW - Enhanced)
2
+ export const componentGuidance = {
3
+ buttons: {
4
+ primary: {
5
+ sizing: "px-6 py-3 (24px horizontal, 12px vertical) minimum",
6
+ fontSize: "16-18px, never below 16px",
7
+ borderRadius: "8-12px for modern feel (or fully rounded with rounded-full)",
8
+ fontWeight: "600 (semi-bold)",
9
+ colors: "High contrast - if bg is blue-600, text should be white",
10
+ hoverEffect: "Darken by 10% or add subtle shadow: shadow-lg",
11
+ example: "bg-blue-600 hover:bg-blue-700 text-white px-8 py-4 rounded-lg font-semibold text-lg"
12
+ },
13
+ secondary: {
14
+ style: "Border style with transparent background",
15
+ example: "border-2 border-gray-300 hover:border-gray-400 text-gray-700 px-6 py-3 rounded-lg"
16
+ },
17
+ modernVariants: [
18
+ "Gradient buttons: from-purple-600 to-blue-600",
19
+ "Glassmorphic: backdrop-blur-md bg-white/10 border border-white/20",
20
+ "Neumorphic: Subtle shadows for depth"
21
+ ]
22
+ },
23
+ cards: {
24
+ modern: {
25
+ background: "White with subtle shadow OR gradient backgrounds",
26
+ shadow: "shadow-lg hover:shadow-xl transition-shadow",
27
+ borderRadius: "12-16px (very rounded corners)",
28
+ padding: "p-6 to p-8 (24-32px)",
29
+ border: "Either no border OR subtle 1px border-gray-200",
30
+ hover: "Transform scale-105 or lift with shadow"
31
+ },
32
+ layout: {
33
+ image: "Rounded corners matching card, aspect-ratio 16:9 or 1:1",
34
+ spacing: "gap-4 between image and content",
35
+ cta: "Place at bottom with mt-auto in flex column"
36
+ }
37
+ },
38
+ forms: {
39
+ inputs: {
40
+ sizing: "h-12 to h-14 (48-56px height) for comfortable interaction",
41
+ padding: "px-4 py-3",
42
+ borderRadius: "8-10px",
43
+ border: "2px solid - gray-300 default, blue-500 on focus",
44
+ fontSize: "16px minimum (prevents zoom on mobile)",
45
+ background: "White or very light gray (gray-50)"
46
+ },
47
+ labels: {
48
+ position: "Above input with mb-2",
49
+ fontSize: "14px",
50
+ fontWeight: "500-600",
51
+ color: "gray-700"
52
+ },
53
+ validation: {
54
+ success: "Green border + checkmark icon",
55
+ error: "Red border + error message below in red text"
56
+ }
57
+ },
58
+ navigation: {
59
+ modern: {
60
+ style: "Clean, minimal, with clear active states",
61
+ linkSpacing: "gap-8 between nav items",
62
+ fontSize: "15-16px",
63
+ fontWeight: "500",
64
+ activeState: "Underline or colored background pill",
65
+ hoverState: "Color change or subtle underline"
66
+ },
67
+ mobile: {
68
+ pattern: "Slide-in drawer OR full-screen overlay",
69
+ animation: "Smooth transition 300ms",
70
+ closeButton: "Clear X icon top-right"
71
+ }
72
+ }
73
+ };
74
+ //# sourceMappingURL=componentGuidance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"componentGuidance.js","sourceRoot":"","sources":["../../src/data/componentGuidance.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,OAAO,EAAE;QACL,OAAO,EAAE;YACL,MAAM,EAAE,oDAAoD;YAC5D,QAAQ,EAAE,2BAA2B;YACrC,YAAY,EAAE,6DAA6D;YAC3E,UAAU,EAAE,iBAAiB;YAC7B,MAAM,EAAE,yDAAyD;YACjE,WAAW,EAAE,+CAA+C;YAC5D,OAAO,EAAE,qFAAqF;SACjG;QACD,SAAS,EAAE;YACP,KAAK,EAAE,0CAA0C;YACjD,OAAO,EAAE,mFAAmF;SAC/F;QACD,cAAc,EAAE;YACZ,+CAA+C;YAC/C,mEAAmE;YACnE,sCAAsC;SACzC;KACJ;IACD,KAAK,EAAE;QACH,MAAM,EAAE;YACJ,UAAU,EAAE,kDAAkD;YAC9D,MAAM,EAAE,6CAA6C;YACrD,YAAY,EAAE,gCAAgC;YAC9C,OAAO,EAAE,sBAAsB;YAC/B,MAAM,EAAE,gDAAgD;YACxD,KAAK,EAAE,yCAAyC;SACnD;QACD,MAAM,EAAE;YACJ,KAAK,EAAE,yDAAyD;YAChE,OAAO,EAAE,iCAAiC;YAC1C,GAAG,EAAE,6CAA6C;SACrD;KACJ;IACD,KAAK,EAAE;QACH,MAAM,EAAE;YACJ,MAAM,EAAE,2DAA2D;YACnE,OAAO,EAAE,WAAW;YACpB,YAAY,EAAE,QAAQ;YACtB,MAAM,EAAE,iDAAiD;YACzD,QAAQ,EAAE,wCAAwC;YAClD,UAAU,EAAE,oCAAoC;SACnD;QACD,MAAM,EAAE;YACJ,QAAQ,EAAE,uBAAuB;YACjC,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,SAAS;YACrB,KAAK,EAAE,UAAU;SACpB;QACD,UAAU,EAAE;YACR,OAAO,EAAE,+BAA+B;YACxC,KAAK,EAAE,8CAA8C;SACxD;KACJ;IACD,UAAU,EAAE;QACR,MAAM,EAAE;YACJ,KAAK,EAAE,0CAA0C;YACjD,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,SAAS;YACnB,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,sCAAsC;YACnD,UAAU,EAAE,kCAAkC;SACjD;QACD,MAAM,EAAE;YACJ,OAAO,EAAE,wCAAwC;YACjD,SAAS,EAAE,yBAAyB;YACpC,WAAW,EAAE,wBAAwB;SACxC;KACJ;CACJ,CAAC"}
@@ -0,0 +1,7 @@
1
+ export declare const designPrinciples: {
2
+ principle: string;
3
+ description: string;
4
+ guidelines: string[];
5
+ commonMistakes: string[];
6
+ }[];
7
+ //# sourceMappingURL=designPrinciples.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"designPrinciples.d.ts","sourceRoot":"","sources":["../../src/data/designPrinciples.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,gBAAgB;;;;;GA+F5B,CAAC"}
@@ -0,0 +1,98 @@
1
+ // Design Principles Database
2
+ export const designPrinciples = [
3
+ {
4
+ principle: "Visual Hierarchy",
5
+ description: "Guide users' attention to the most important content first",
6
+ guidelines: [
7
+ "Size: Make primary headlines 2-3x larger than body text",
8
+ "Color: Use bold/saturated colors for important elements, muted for secondary",
9
+ "Contrast: High contrast draws attention, low contrast recedes",
10
+ "Position: Place key content in the top-left or center (natural reading flow)",
11
+ "Weight: Bold text naturally draws the eye before regular weight"
12
+ ],
13
+ commonMistakes: [
14
+ "Everything being the same size",
15
+ "Too many competing focal points",
16
+ "Important CTAs blending into the background"
17
+ ]
18
+ },
19
+ {
20
+ principle: "Whitespace",
21
+ description: "Empty space that gives content room to breathe and creates focus",
22
+ guidelines: [
23
+ "Section spacing: Use 80-120px between major sections",
24
+ "Element spacing: 24-48px padding inside cards and containers",
25
+ "Text: Line height of 1.5-1.7 for body text, 1.1-1.3 for headlines",
26
+ "Margins: Consistent spacing scale (8, 16, 24, 32, 48, 64, 96px)",
27
+ "Don't fear empty space - it's a design element, not wasted space"
28
+ ],
29
+ commonMistakes: [
30
+ "Cramming too much content together",
31
+ "Inconsistent spacing throughout the page",
32
+ "No breathing room around text blocks"
33
+ ]
34
+ },
35
+ {
36
+ principle: "Consistency",
37
+ description: "Uniform patterns that create familiarity and reduce cognitive load",
38
+ guidelines: [
39
+ "Use the same button styles throughout",
40
+ "Maintain consistent heading sizes (h1, h2, h3 scale)",
41
+ "Apply the same border-radius to all rounded elements",
42
+ "Use a defined color palette - don't introduce random colors",
43
+ "Keep icon style uniform (all outlined OR all filled, same weight)"
44
+ ],
45
+ commonMistakes: [
46
+ "Mixing different button styles",
47
+ "Random border-radius values",
48
+ "Inconsistent icon styles"
49
+ ]
50
+ },
51
+ {
52
+ principle: "Contrast",
53
+ description: "Visual distinction between elements for readability and emphasis",
54
+ guidelines: [
55
+ "Text contrast: Minimum 4.5:1 ratio for body, 3:1 for large text",
56
+ "Size contrast: Headlines should be noticeably larger, not just slightly",
57
+ "Color contrast: CTAs should pop against their background",
58
+ "Weight contrast: Mix light and bold weights purposefully"
59
+ ],
60
+ commonMistakes: [
61
+ "Gray text on gray background",
62
+ "Subtle size differences that look like mistakes",
63
+ "Primary buttons that don't stand out"
64
+ ]
65
+ },
66
+ {
67
+ principle: "Alignment",
68
+ description: "Clean visual connections that create order and professionalism",
69
+ guidelines: [
70
+ "Use the grid system (12-column is standard)",
71
+ "Left-align body text for readability",
72
+ "Center-align short headlines and CTAs for emphasis",
73
+ "Align elements to invisible vertical lines",
74
+ "Keep consistent left margins throughout sections"
75
+ ],
76
+ commonMistakes: [
77
+ "Elements that almost align but don't quite",
78
+ "Mixing center and left alignment randomly",
79
+ "No underlying grid structure"
80
+ ]
81
+ },
82
+ {
83
+ principle: "Proximity",
84
+ description: "Group related items to show relationships",
85
+ guidelines: [
86
+ "Related items should be closer together than unrelated items",
87
+ "Use cards to visually group content",
88
+ "Form labels should be closer to their inputs than to other fields",
89
+ "Create clear section breaks with spacing, not just lines"
90
+ ],
91
+ commonMistakes: [
92
+ "Equal spacing between everything",
93
+ "Labels far from their associated elements",
94
+ "No visual grouping of related content"
95
+ ]
96
+ }
97
+ ];
98
+ //# sourceMappingURL=designPrinciples.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"designPrinciples.js","sourceRoot":"","sources":["../../src/data/designPrinciples.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B;QACI,SAAS,EAAE,kBAAkB;QAC7B,WAAW,EAAE,4DAA4D;QACzE,UAAU,EAAE;YACR,yDAAyD;YACzD,8EAA8E;YAC9E,+DAA+D;YAC/D,8EAA8E;YAC9E,iEAAiE;SACpE;QACD,cAAc,EAAE;YACZ,gCAAgC;YAChC,iCAAiC;YACjC,6CAA6C;SAChD;KACJ;IACD;QACI,SAAS,EAAE,YAAY;QACvB,WAAW,EAAE,kEAAkE;QAC/E,UAAU,EAAE;YACR,sDAAsD;YACtD,8DAA8D;YAC9D,mEAAmE;YACnE,iEAAiE;YACjE,kEAAkE;SACrE;QACD,cAAc,EAAE;YACZ,oCAAoC;YACpC,0CAA0C;YAC1C,sCAAsC;SACzC;KACJ;IACD;QACI,SAAS,EAAE,aAAa;QACxB,WAAW,EAAE,oEAAoE;QACjF,UAAU,EAAE;YACR,uCAAuC;YACvC,sDAAsD;YACtD,sDAAsD;YACtD,6DAA6D;YAC7D,mEAAmE;SACtE;QACD,cAAc,EAAE;YACZ,gCAAgC;YAChC,6BAA6B;YAC7B,0BAA0B;SAC7B;KACJ;IACD;QACI,SAAS,EAAE,UAAU;QACrB,WAAW,EAAE,kEAAkE;QAC/E,UAAU,EAAE;YACR,iEAAiE;YACjE,yEAAyE;YACzE,0DAA0D;YAC1D,0DAA0D;SAC7D;QACD,cAAc,EAAE;YACZ,8BAA8B;YAC9B,iDAAiD;YACjD,sCAAsC;SACzC;KACJ;IACD;QACI,SAAS,EAAE,WAAW;QACtB,WAAW,EAAE,gEAAgE;QAC7E,UAAU,EAAE;YACR,6CAA6C;YAC7C,sCAAsC;YACtC,oDAAoD;YACpD,4CAA4C;YAC5C,kDAAkD;SACrD;QACD,cAAc,EAAE;YACZ,4CAA4C;YAC5C,2CAA2C;YAC3C,8BAA8B;SACjC;KACJ;IACD;QACI,SAAS,EAAE,WAAW;QACtB,WAAW,EAAE,2CAA2C;QACxD,UAAU,EAAE;YACR,8DAA8D;YAC9D,qCAAqC;YACrC,mEAAmE;YACnE,0DAA0D;SAC7D;QACD,cAAc,EAAE;YACZ,kCAAkC;YAClC,2CAA2C;YAC3C,uCAAuC;SAC1C;KACJ;CACJ,CAAC"}
@@ -0,0 +1,45 @@
1
+ export declare const liveInspirationSources: {
2
+ portfolios: {
3
+ name: string;
4
+ url: string;
5
+ categories: string[];
6
+ updateFrequency: string;
7
+ bestFor: string;
8
+ }[];
9
+ componentLibraries: {
10
+ aceternity: {
11
+ url: string;
12
+ style: string;
13
+ components: string[];
14
+ };
15
+ magicui: {
16
+ url: string;
17
+ style: string;
18
+ components: string[];
19
+ };
20
+ shadcn: {
21
+ url: string;
22
+ style: string;
23
+ components: string[];
24
+ };
25
+ };
26
+ realSiteExamples: {
27
+ "linear.app": {
28
+ inspireFrom: string[];
29
+ avoid: string[];
30
+ };
31
+ "stripe.com": {
32
+ inspireFrom: string[];
33
+ avoid: string[];
34
+ };
35
+ "vercel.com": {
36
+ inspireFrom: string[];
37
+ avoid: string[];
38
+ };
39
+ "pitch.com": {
40
+ inspireFrom: string[];
41
+ avoid: string[];
42
+ };
43
+ };
44
+ };
45
+ //# sourceMappingURL=inspiration.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inspiration.d.ts","sourceRoot":"","sources":["../../src/data/inspiration.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkElC,CAAC"}
@@ -0,0 +1,68 @@
1
+ export const liveInspirationSources = {
2
+ portfolios: [
3
+ {
4
+ name: "Godly",
5
+ url: "https://godly.website/",
6
+ categories: ["trending", "website-design", "dark", "minimal"],
7
+ updateFrequency: "daily",
8
+ bestFor: "Current design trends, visual inspiration"
9
+ },
10
+ {
11
+ name: "Awwwards",
12
+ url: "https://www.awwwards.com/websites/",
13
+ categories: ["site-of-the-day", "developer-award", "mobile-excellence"],
14
+ updateFrequency: "daily",
15
+ bestFor: "Award-winning designs, cutting-edge techniques"
16
+ },
17
+ {
18
+ name: "Landbook",
19
+ url: "https://land-book.com/",
20
+ categories: ["saas", "agency", "portfolio", "ecommerce"],
21
+ updateFrequency: "weekly",
22
+ bestFor: "Landing page specific designs"
23
+ },
24
+ {
25
+ name: "SiteInspire",
26
+ url: "https://www.siteinspire.com/",
27
+ categories: ["interactive", "minimal", "portfolio"],
28
+ updateFrequency: "weekly",
29
+ bestFor: "Clean, professional designs"
30
+ }
31
+ ],
32
+ componentLibraries: {
33
+ aceternity: {
34
+ url: "https://ui.aceternity.com/components",
35
+ style: "Premium, animated, modern",
36
+ components: ["hero sections", "bento grids", "3d cards", "animated backgrounds"]
37
+ },
38
+ magicui: {
39
+ url: "https://magicui.design/docs/components",
40
+ style: "Playful, interactive, React-focused",
41
+ components: ["animated text", "particles", "marquee", "charts"]
42
+ },
43
+ shadcn: {
44
+ url: "https://ui.shadcn.com/",
45
+ style: "Clean, accessible, composable",
46
+ components: ["forms", "dialogs", "navigation", "data display"]
47
+ }
48
+ },
49
+ realSiteExamples: {
50
+ "linear.app": {
51
+ inspireFrom: ["animations", "typography", "color restraint", "purposeful motion"],
52
+ avoid: ["complexity", "over-decoration"]
53
+ },
54
+ "stripe.com": {
55
+ inspireFrom: ["gradient usage", "bold headers", "clear hierarchy", "documentation style"],
56
+ avoid: ["plain minimalism"]
57
+ },
58
+ "vercel.com": {
59
+ inspireFrom: ["dark mode", "subtle animations", "code presentation", "clean layouts"],
60
+ avoid: ["light mode as primary"]
61
+ },
62
+ "pitch.com": {
63
+ inspireFrom: ["color blocking", "playful typography", "asymmetric layouts", "energy"],
64
+ avoid: ["conservative design"]
65
+ }
66
+ }
67
+ };
68
+ //# sourceMappingURL=inspiration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inspiration.js","sourceRoot":"","sources":["../../src/data/inspiration.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,UAAU,EAAE;QACR;YACI,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,wBAAwB;YAC7B,UAAU,EAAE,CAAC,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,CAAC;YAC7D,eAAe,EAAE,OAAO;YACxB,OAAO,EAAE,2CAA2C;SACvD;QACD;YACI,IAAI,EAAE,UAAU;YAChB,GAAG,EAAE,oCAAoC;YACzC,UAAU,EAAE,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,CAAC;YACvE,eAAe,EAAE,OAAO;YACxB,OAAO,EAAE,gDAAgD;SAC5D;QACD;YACI,IAAI,EAAE,UAAU;YAChB,GAAG,EAAE,wBAAwB;YAC7B,UAAU,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC;YACxD,eAAe,EAAE,QAAQ;YACzB,OAAO,EAAE,+BAA+B;SAC3C;QACD;YACI,IAAI,EAAE,aAAa;YACnB,GAAG,EAAE,8BAA8B;YACnC,UAAU,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,WAAW,CAAC;YACnD,eAAe,EAAE,QAAQ;YACzB,OAAO,EAAE,6BAA6B;SACzC;KACJ;IACD,kBAAkB,EAAE;QAChB,UAAU,EAAE;YACR,GAAG,EAAE,sCAAsC;YAC3C,KAAK,EAAE,2BAA2B;YAClC,UAAU,EAAE,CAAC,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,sBAAsB,CAAC;SACnF;QACD,OAAO,EAAE;YACL,GAAG,EAAE,wCAAwC;YAC7C,KAAK,EAAE,qCAAqC;YAC5C,UAAU,EAAE,CAAC,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC;SAClE;QACD,MAAM,EAAE;YACJ,GAAG,EAAE,wBAAwB;YAC7B,KAAK,EAAE,+BAA+B;YACtC,UAAU,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,CAAC;SACjE;KACJ;IACD,gBAAgB,EAAE;QACd,YAAY,EAAE;YACV,WAAW,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,CAAC;YACjF,KAAK,EAAE,CAAC,YAAY,EAAE,iBAAiB,CAAC;SAC3C;QACD,YAAY,EAAE;YACV,WAAW,EAAE,CAAC,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,qBAAqB,CAAC;YACzF,KAAK,EAAE,CAAC,kBAAkB,CAAC;SAC9B;QACD,YAAY,EAAE;YACV,WAAW,EAAE,CAAC,WAAW,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,CAAC;YACrF,KAAK,EAAE,CAAC,uBAAuB,CAAC;SACnC;QACD,WAAW,EAAE;YACT,WAAW,EAAE,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,QAAQ,CAAC;YACrF,KAAK,EAAE,CAAC,qBAAqB,CAAC;SACjC;KACJ;CACJ,CAAC"}