You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/docs/home/overview/introduction/index.mdx
+67-3Lines changed: 67 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,71 @@ import { GithubLink } from './githubLink';
10
10
11
11
Customizable components and patterns for React, Next.js & React Native.
12
12
13
-
**gluestack-ui v3** offers customizable, beautifully designed components for your projects. Unlike traditional libraries, it's not a pre-packaged dependency. Choose the components you need and copy-paste them directly into your React, Next.js & React Native projects.
13
+
**gluestack-ui** offers customizable, beautifully designed components for your projects. Unlike traditional libraries, it's not a pre-packaged dependency. Choose the components you need and copy-paste them directly into your React, Next.js & React Native projects.
14
+
15
+
## gluestack-ui philosophy
16
+
17
+
### Why gluestack-ui exists
18
+
-**Problem:** Traditional UI libraries often force developers into rigid patterns, heavy dependencies, or platform-specific implementations.
19
+
20
+
-**Solution:** Gluestack promotes a universal, modular, and copy-paste approach that lets developers own their UI components completely.
21
+
22
+
### Goals & Non-Goals
23
+
24
+
#### Our goals
25
+
26
+
-**Universal Consistency:** One codebase, same behavior across React, Next.js, and React Native.
-**Performance & Accessibility:** Lightweight, optimized, and accessible components by default.
31
+
32
+
-**Community-Driven:** Open architecture encouraging contributions and experimentation.
33
+
34
+
#### Non-goals
35
+
36
+
**We don't aim to**
37
+
- Create another monolithic UI library with hundreds of pre-styled components
38
+
- Provide opinionated design themes that limit creative freedom
39
+
- Replace platform-specific optimizations with lowest-common-denominator solutions
40
+
- Build a proprietary styling system that requires learning new APIs
41
+
- Create dependencies that become bottlenecks for your project's evolution
42
+
43
+
### How gluestack-ui works
44
+
45
+
-**Source-to-Destination Architecture:** Maintain a single source of truth for components that automatically syncs across projects.
46
+
47
+
-**Copy-Paste Components:** Grab only what you need—no heavy dependencies required.
48
+
49
+
-**Theming & Tailwind Integration:** Flexible styling system that works for web & mobile.
50
+
51
+
-**TypeScript & RSC Ready:** Modern architecture for type safety and server-rendered apps.
52
+
53
+
### Design 101
54
+
55
+
-**Atomic, Composable Components:** Each component is small, reusable, and composable into more complex UIs.
56
+
57
+
-**Compound Components:** Components with sub-components (e.g.,
58
+
`<Button>`
59
+
`<ButtonText>`Click Me`</ButtonText>`
60
+
`</Button>`
61
+
), allowing more flexible layouts.
62
+
63
+
-**Accessibility by Default:** ARIA support baked in, keyboard navigable.
64
+
65
+
-**Minimal Runtime Overhead:** Lightweight runtime ensures high performance.
66
+
67
+
### Code 101
68
+
69
+
-**Copy-Paste Philosophy:** No “magical imports.” You copy the component directly into your codebase.
70
+
71
+
-**Fully Customizable:** You can override styles, props, and behavior easily.
72
+
73
+
-**Single Source of Truth:** All component logic lives in src/ for maintainability and easy updates.
74
+
75
+
-**Integration Ready:** Works out-of-the-box with Tailwind, NativeWind, and Next.js RSC.
76
+
77
+
This philosophy guides every decision in gluestack-ui's development, from API design to documentation structure, ensuring that developers have the tools they need to build exceptional user experiences without compromise.
0 commit comments