Skip to content

Commit 7858a1d

Browse files
Copilothuangyiirene
andcommitted
Add discoverability improvements: homepage card, navigation link, and comprehensive demos page
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
1 parent 27fd7c9 commit 7858a1d

3 files changed

Lines changed: 248 additions & 15 deletions

File tree

apps/site/app/page.tsx

Lines changed: 31 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -243,22 +243,38 @@ export default function HomePage() {
243243

244244
<div className="mx-auto grid max-w-6xl grid-cols-1 gap-6 sm:grid-cols-2 lg:grid-cols-3">
245245
{[
246-
{ icon: "📊", title: "Dashboards", desc: "Data visualization and analytics" },
247-
{ icon: "⚙️", title: "Admin Panels", desc: "Complete CRUD interfaces" },
248-
{ icon: "📝", title: "Forms", desc: "Complex multi-step forms" },
249-
{ icon: "📄", title: "CMS", desc: "Content management systems" },
250-
{ icon: "🔧", title: "Internal Tools", desc: "Business applications" },
251-
{ icon: "🎨", title: "Prototypes", desc: "Rapid UI prototyping" }
246+
{ icon: "📊", title: "Dashboards", desc: "Data visualization and analytics", link: null },
247+
{ icon: "⚙️", title: "Admin Panels", desc: "Complete CRUD interfaces", link: null },
248+
{ icon: "📝", title: "Forms", desc: "Complex multi-step forms", link: null },
249+
{ icon: "📄", title: "CMS", desc: "Content management systems", link: null },
250+
{ icon: "🔧", title: "Internal Tools", desc: "Business applications", link: null },
251+
{ icon: "", title: "Interactive Examples", desc: "Explore 30+ components with live demos", link: "/docs/guide/interactive-demos" }
252252
].map((useCase) => (
253-
<div key={useCase.title} className="rounded-xl border border-fd-border bg-fd-card p-6">
254-
<div className="text-4xl mb-3">{useCase.icon}</div>
255-
<h3 className="text-lg font-semibold text-fd-foreground mb-1">
256-
{useCase.title}
257-
</h3>
258-
<p className="text-fd-muted-foreground text-sm">
259-
{useCase.desc}
260-
</p>
261-
</div>
253+
useCase.link ? (
254+
<Link
255+
key={useCase.title}
256+
href={useCase.link}
257+
className="rounded-xl border border-fd-border bg-fd-card p-6 transition-all hover:shadow-lg hover:border-fd-primary/50"
258+
>
259+
<div className="text-4xl mb-3">{useCase.icon}</div>
260+
<h3 className="text-lg font-semibold text-fd-foreground mb-1">
261+
{useCase.title}
262+
</h3>
263+
<p className="text-fd-muted-foreground text-sm">
264+
{useCase.desc}
265+
</p>
266+
</Link>
267+
) : (
268+
<div key={useCase.title} className="rounded-xl border border-fd-border bg-fd-card p-6">
269+
<div className="text-4xl mb-3">{useCase.icon}</div>
270+
<h3 className="text-lg font-semibold text-fd-foreground mb-1">
271+
{useCase.title}
272+
</h3>
273+
<p className="text-fd-muted-foreground text-sm">
274+
{useCase.desc}
275+
</p>
276+
</div>
277+
)
262278
))}
263279
</div>
264280
</div>

docs/guide/interactive-demos.md

Lines changed: 216 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,216 @@
1+
---
2+
title: "Interactive Component Demos"
3+
description: "Explore all ObjectUI components and plugins with live interactive examples"
4+
---
5+
6+
# Interactive Component Demos
7+
8+
Explore ObjectUI's comprehensive component library with **live interactive demos**. Each demo features:
9+
10+
- 👁️ **Live Preview** - See components in action
11+
- 💻 **Source Code** - View and copy JSON schemas
12+
- 📋 **Copy Button** - One-click code copying
13+
- 🎨 **Multiple Examples** - Various use cases
14+
15+
## 🧩 Components by Category
16+
17+
### Form Components
18+
19+
Build powerful forms with our comprehensive form controls:
20+
21+
- **[Input](/docs/components/form/input)** - Text input fields with validation
22+
- **[Select](/docs/components/form/select)** - Dropdown selection menus
23+
- **[Checkbox](/docs/components/form/checkbox)** - Toggle selection boxes
24+
- **[Switch](/docs/components/form/switch)** - Binary toggle switches
25+
- **[Textarea](/docs/components/form/textarea)** - Multi-line text input
26+
- **[Slider](/docs/components/form/slider)** - Range selection sliders
27+
- **[Button](/docs/components/form/button)** - Action triggers with variants
28+
29+
### Layout Components
30+
31+
Structure your UI with flexible layout containers:
32+
33+
- **[Stack](/docs/components/layout/stack)** - Vertical/horizontal stacking
34+
- **[Grid](/docs/components/layout/grid)** - Responsive grid layouts
35+
- **[Card](/docs/components/layout/card)** - Content containers
36+
- **[Tabs](/docs/components/layout/tabs)** - Tabbed content sections
37+
- **[Separator](/docs/components/layout/separator)** - Visual dividers
38+
39+
### Overlay Components
40+
41+
Create modal and overlay experiences:
42+
43+
- **[Dialog](/docs/components/overlay/dialog)** - Modal dialogs
44+
- **[Drawer](/docs/components/overlay/drawer)** - Sliding side panels
45+
- **[Tooltip](/docs/components/overlay/tooltip)** - Contextual hints
46+
- **[Popover](/docs/components/overlay/popover)** - Floating content panels
47+
48+
### Data Display Components
49+
50+
Present information beautifully:
51+
52+
- **[Table](/docs/components/data-display/table)** - Tabular data display
53+
- **[List](/docs/components/data-display/list)** - Ordered/unordered lists
54+
- **[Avatar](/docs/components/data-display/avatar)** - User profile images
55+
- **[Badge](/docs/components/data-display/badge)** - Status indicators
56+
- **[Alert](/docs/components/data-display/alert)** - Notification messages
57+
58+
### Feedback Components
59+
60+
Provide user feedback and status:
61+
62+
- **[Progress](/docs/components/feedback/progress)** - Progress indicators
63+
- **[Loading](/docs/components/feedback/loading)** - Loading spinners
64+
- **[Skeleton](/docs/components/feedback/skeleton)** - Loading placeholders
65+
- **[Toast](/docs/components/feedback/toast)** - Toast notifications
66+
67+
### Disclosure Components
68+
69+
Progressive content disclosure:
70+
71+
- **[Accordion](/docs/components/disclosure/accordion)** - Collapsible sections
72+
- **[Collapse](/docs/components/disclosure/collapse)** - Show/hide content
73+
74+
### Complex Components
75+
76+
Advanced composite components:
77+
78+
- **[Command](/docs/components/complex/command)** - Command palette
79+
- **[DatePicker](/docs/components/complex/date-picker)** - Date selection
80+
81+
## 🔌 Plugin Demos
82+
83+
Extend ObjectUI with powerful plugins:
84+
85+
### [Plugin Markdown](/docs/ecosystem/plugins/plugin-markdown)
86+
87+
Render GitHub Flavored Markdown with syntax highlighting:
88+
89+
- ✅ Basic formatting (bold, italic, links)
90+
- ✅ Task lists with checkboxes
91+
- ✅ Tables and code blocks
92+
- ✅ XSS protection built-in
93+
94+
**Interactive Examples**: 3 live demos
95+
96+
### [Plugin Kanban](/docs/ecosystem/plugins/plugin-kanban)
97+
98+
Drag-and-drop Kanban boards for project management:
99+
100+
- ✅ Drag cards between columns
101+
- ✅ WIP limits per column
102+
- ✅ Card badges for status/priority
103+
- ✅ Keyboard navigation support
104+
105+
**Interactive Examples**: 2 live demos
106+
107+
### [Plugin Charts](/docs/ecosystem/plugins/plugin-charts)
108+
109+
Beautiful data visualizations powered by Recharts:
110+
111+
- ✅ Bar, line, area, pie charts
112+
- ✅ Responsive design
113+
- ✅ Customizable colors
114+
- ✅ Multiple data series
115+
116+
**Interactive Examples**: 3 live demos
117+
118+
### [Plugin Editor](/docs/ecosystem/plugins/plugin-editor)
119+
120+
Monaco Editor integration for code editing:
121+
122+
- ✅ 100+ programming languages
123+
- ✅ IntelliSense & autocomplete
124+
- ✅ Syntax highlighting
125+
- ✅ Find and replace
126+
127+
**Interactive Examples**: 3 live demos
128+
129+
### [Plugin Object](/docs/ecosystem/plugins/plugin-object)
130+
131+
ObjectQL integration for CRUD operations:
132+
133+
- ✅ Auto-generated tables
134+
- ✅ Smart forms with validation
135+
- ✅ Complete CRUD views
136+
- ✅ Schema-driven UI
137+
138+
**Interactive Examples**: 3 live demos
139+
140+
## 🚀 Quick Start
141+
142+
### 1. Browse Components
143+
144+
Click any component link above to see:
145+
- Live interactive preview
146+
- JSON schema code
147+
- Multiple usage examples
148+
149+
### 2. Copy Code
150+
151+
Each demo has a **Code tab** with:
152+
- Formatted JSON schema
153+
- Copy button for instant use
154+
- Syntax highlighting
155+
156+
### 3. Use in Your Project
157+
158+
```tsx
159+
import { SchemaRenderer } from '@object-ui/react';
160+
161+
const schema = {
162+
type: "input",
163+
label: "Email",
164+
placeholder: "user@example.com"
165+
};
166+
167+
<SchemaRenderer schema={schema} />
168+
```
169+
170+
## 💡 How Interactive Demos Work
171+
172+
Each component page uses our new **InteractiveDemo** component:
173+
174+
```tsx
175+
<InteractiveDemo
176+
schema={{
177+
type: "button",
178+
label: "Click me",
179+
variant: "default"
180+
}}
181+
title="Primary Button"
182+
description="Main action button"
183+
/>
184+
```
185+
186+
### Features
187+
188+
- **Tab Switching** - Toggle between Preview and Code views
189+
- **Live Rendering** - See components rendered in real-time
190+
- **Copy Button** - One-click code copying
191+
- **Multi-Example** - Show related variations together
192+
- **Responsive** - Works on all screen sizes
193+
194+
## 📚 Component Reference
195+
196+
For complete API documentation including all props, events, and advanced usage:
197+
198+
- **[Component Registry](/docs/concepts/component-registry)** - All available component types
199+
- **[Schema Rendering](/docs/concepts/schema-rendering)** - How the rendering engine works
200+
- **[Plugin System](/docs/concepts/plugins)** - Creating custom plugins
201+
202+
## 🎨 Design Resources
203+
204+
- **[Tailwind Integration](/docs/guide/components#styling)** - Using Tailwind classes
205+
- **[Theming](/docs/guide/components#theming)** - Light/dark mode support
206+
- **[Accessibility](/docs/guide/components#accessibility)** - WCAG 2.1 compliance
207+
208+
## 🔗 Next Steps
209+
210+
- **[Quick Start Guide](/docs/guide/quick-start)** - Get up and running in 5 minutes
211+
- **[Try It Online](/docs/guide/try-it-online)** - Online playground
212+
- **[GitHub Repository](https://github.com/objectstack-ai/objectui)** - Star the project
213+
214+
---
215+
216+
**Have questions?** Check out our [Getting Started Guide](/docs/guide/quick-start) or visit the [GitHub Discussions](https://github.com/objectstack-ai/objectui/discussions).

docs/guide/meta.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@
44
"index",
55
"installation",
66
"quick-start",
7+
"interactive-demos",
78
"studio",
89
"cli",
910
"try-it-online",

0 commit comments

Comments
 (0)