Skip to content

Commit 31c8edb

Browse files
committed
add images to design guidelines and color palette section
1 parent ad1c794 commit 31c8edb

1 file changed

Lines changed: 35 additions & 2 deletions

File tree

docs/mini-apps/get-distribution/design-guidelines.mdx

Lines changed: 35 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,43 @@ description: "Build a mini app that is intuitive and delightful to use."
1414
### Navigation
1515

1616
* Most mini apps should include a **bottom navigation bar**.
17+
18+
<img
19+
src="/images/design-guidelines/navigation-tab.png"
20+
alt="Bottom navigation bar example"
21+
className="rounded-lg"
22+
/>
23+
24+
* A side menu can also be an intuitive place to put settings and user profile information.
25+
<img
26+
src="/images/design-guidelines/navigation-sidebar.png"
27+
alt="Side navigation menu example"
28+
className="rounded-lg"
29+
/>
30+
1731
* Always include **labels under icons** so users understand each tab.
1832
* Test on multiple device sizes to ensure buttons are not cut off.
1933

2034

35+
### Colors
36+
37+
Use color to communicate clearly, express your brand, and create cohesive mini app experiences.
38+
39+
### **Color Palette**
40+
41+
* **Primary:** Brand color for CTAs and key interactions.
42+
* **Secondary:** Complements primary; use for accents or secondary actions.
43+
* **Neutral:** For text, backgrounds, and structure with strong contrast.
44+
45+
### **Themes**
46+
47+
* Support **light and dark modes**:
48+
* Maintain contrast and brand consistency.
49+
* Respect system preference but allow manual toggle.
50+
* Use smooth transitions between themes.
51+
* **💡Tip:** Use **semantic color tokens** (e.g., `--color-primary`, `--color-background`) with **light/dark theme overrides** for maintainability and flexibility.
52+
53+
2154
### Typography
2255

2356
* Ensure the fonts you use are easy to read. Our team recommends **Inter.**
@@ -30,10 +63,10 @@ description: "Build a mini app that is intuitive and delightful to use."
3063
* Consistent spacing: Creates visual rhythm and predictability with consistent spacing.
3164
* Give content room to breathe with white space.
3265
* Avoid cramped layouts.
33-
* Base Unit: Start with a base spacing unit (typically **4px** or **8px**):
66+
* Base Unit: Start with a base spacing unit (typically **4px** or **8px**) and maintain consistency throughout:
3467
* 4px base: More granular control, better for mobile.
3568
* 8px base: Easier mental math, good for desktop.
36-
* Choose one: Maintain consistency throughout.
69+
3770

3871
### Touch Interactions
3972

0 commit comments

Comments
 (0)