Skip to content

Commit 8cf2590

Browse files
committed
Update docs navigation and homepage links
Updated internal documentation links in the homepage and hero section to reflect new URL structure and improved navigation. Revised the main docs index to focus on the three core ObjectStack protocols, streamlined resource cards, and removed outdated quick links and module descriptions for clarity.
1 parent 2009b94 commit 8cf2590

File tree

3 files changed

+38
-76
lines changed

3 files changed

+38
-76
lines changed

apps/docs/app/[lang]/page.tsx

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -38,37 +38,37 @@ export default async function HomePage({
3838
<FeatureCard
3939
icon={<Database className="h-6 w-6" />}
4040
title={t.features.objectql.title}
41-
href="/docs/specifications/data/architecture"
41+
href="/docs/objectql"
4242
description={t.features.objectql.description}
4343
/>
4444
<FeatureCard
4545
icon={<Layers className="h-6 w-6" />}
4646
title={t.features.objectui.title}
47-
href="/docs/specifications/ui/sdui-protocol"
47+
href="/docs/objectui"
4848
description={t.features.objectui.description}
4949
/>
5050
<FeatureCard
5151
icon={<Zap className="h-6 w-6" />}
5252
title={t.features.objectos.title}
53-
href="/docs/specifications/server/kernel-architecture"
53+
href="/docs/objectos"
5454
description={t.features.objectos.description}
5555
/>
5656
<FeatureCard
5757
icon={<ShieldCheck className="h-6 w-6" />}
5858
title={t.features.security.title}
59-
href="/docs/specifications/server/permission-governance"
59+
href="/docs/objectql/security"
6060
description={t.features.security.description}
6161
/>
6262
<FeatureCard
6363
icon={<FileJson className="h-6 w-6" />}
6464
title={t.features.zodFirst.title}
65-
href="/docs/specifications/data/schema-definition"
65+
href="/docs/objectql/schema"
6666
description={t.features.zodFirst.description}
6767
/>
6868
<FeatureCard
6969
icon={<Globe className="h-6 w-6" />}
7070
title={t.features.universal.title}
71-
href="/docs/concepts/architecture"
71+
href="/docs/introduction/architecture"
7272
description={t.features.universal.description}
7373
/>
7474
</div>
@@ -83,21 +83,21 @@ export default async function HomePage({
8383
icon={<LayoutTemplate className="w-8 h-8 text-blue-500" />}
8484
title={t.personas.architect.title}
8585
description={t.personas.architect.description}
86-
href="/docs/concepts/enterprise-patterns"
86+
href="/docs/introduction/architecture"
8787
action={t.personas.architect.action}
8888
/>
8989
<PersonaCard
9090
icon={<Bot className="w-8 h-8 text-purple-500" />}
9191
title={t.personas.aiEngineer.title}
9292
description={t.personas.aiEngineer.description}
93-
href="/docs/concepts/ai-codex"
93+
href="/docs/introduction/metadata-driven"
9494
action={t.personas.aiEngineer.action}
9595
/>
9696
<PersonaCard
9797
icon={<Cpu className="w-8 h-8 text-green-500" />}
9898
title={t.personas.frameworkBuilder.title}
9999
description={t.personas.frameworkBuilder.description}
100-
href="/docs/specifications/data/architecture"
100+
href="/docs/developers"
101101
action={t.personas.frameworkBuilder.action}
102102
/>
103103
</div>

apps/docs/components/hero-section.tsx

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -51,12 +51,6 @@ export function HeroSection({ badge, title, subtitle, cta, className }: HeroSect
5151

5252
{/* CTA Buttons */}
5353
<div className="flex flex-col sm:flex-row items-center justify-center gap-4 pt-4">
54-
<Link
55-
href="/docs/guides/getting-started"
56-
className="inline-flex h-12 items-center justify-center rounded-lg bg-primary px-8 text-sm font-medium text-primary-foreground shadow-lg shadow-primary/20 transition-all hover:bg-primary/90 hover:scale-105 hover:shadow-xl hover:shadow-primary/30 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50"
57-
>
58-
{cta.primary}
59-
</Link>
6054
<Link
6155
href="/docs"
6256
className="inline-flex h-12 items-center justify-center rounded-lg border border-border bg-card/50 px-8 text-sm font-medium shadow-sm transition-all hover:bg-accent hover:text-accent-foreground backdrop-blur-sm hover:scale-105 hover:shadow-md focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50"

content/docs/index.mdx

Lines changed: 29 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -3,94 +3,62 @@ title: Welcome to ObjectStack
33
description: The Metadata-Driven Protocol for the Post-SaaS Era.
44
---
55

6-
import { Book, Compass, FileText, Layers } from 'lucide-react';
6+
import { Book, Compass, FileText, Layers, Database, Layout, Cpu, Code2 } from 'lucide-react';
77

88
**ObjectStack** is not just a framework; it is a **Protocol** for building enterprise software.
99
It decouples the *Business Intent* (defined in JSON/YAML) from the *Technical Execution* (handled by the Kernel).
1010

1111
This documentation is the authoritative reference for the ObjectStack Protocol.
1212

13-
## How to navigate
13+
## The Three Pillars
14+
15+
ObjectStack is built on three foundational protocols that work together as a unified system:
1416

1517
<Cards>
1618
<Card
17-
icon={<FileText />}
18-
title="Quick Start"
19-
href="/docs/quick-start"
20-
description="Get started in under 5 minutes. Choose your learning path based on your role."
21-
/>
22-
<Card
23-
icon={<Book />}
24-
title="Tutorials"
25-
href="/docs/tutorials"
26-
description="Hands-on step-by-step tutorials to build real applications and learn by doing."
19+
icon={<Database />}
20+
title="ObjectQL"
21+
href="/docs/objectql"
22+
description="The Data Protocol. Define your Data Model (Objects, Fields) and query it abstractly."
2723
/>
2824
<Card
29-
icon={<Compass />}
30-
title="Concepts"
31-
href="/docs/concepts/manifesto"
32-
description="Understand the philosophy of 'Intent over Implementation' and the 'Local-First' architecture."
25+
icon={<Layout />}
26+
title="ObjectUI"
27+
href="/docs/objectui"
28+
description="The UI Protocol. Define your User Interfaces (Views, Actions) as pure data."
3329
/>
3430
<Card
35-
icon={<Layers />}
36-
title="Specifications"
37-
href="/docs/specifications"
38-
description="The Architecture Blueprints. Deep dive into ObjectQL (Data), ObjectUI (View), and ObjectOS (Control)."
31+
icon={<Cpu />}
32+
title="ObjectOS"
33+
href="/docs/objectos"
34+
description="The System Protocol. The Kernel that handles Identity, Transport, and Plugins."
3935
/>
4036
</Cards>
4137

42-
## Additional Resources
38+
## Getting Started
4339

4440
<Cards>
4541
<Card
46-
icon={<FileText />}
47-
title="Developer Guides"
48-
href="/docs/guides/getting-started"
49-
description="Comprehensive guides for building with ObjectStack. Field types, views, workflows, and more."
50-
/>
51-
<Card
52-
icon={<Book />}
53-
title="API Reference"
54-
href="/docs/references/data/core/Object"
55-
description="Complete API documentation for every schema, field type, and configuration option."
56-
/>
57-
<Card
58-
icon={<FileText />}
59-
title="FAQ"
60-
href="/docs/faq"
61-
description="Frequently asked questions about ObjectStack and how to use it."
42+
icon={<Compass />}
43+
title="Introduction"
44+
href="/docs/introduction"
45+
description="Understand the philosophy: 'Intent over Implementation' and Metadata-Driven Architecture."
6246
/>
6347
<Card
64-
icon={<FileText />}
65-
title="Troubleshooting"
66-
href="/docs/troubleshooting"
67-
description="Common issues and how to resolve them."
48+
icon={<Code2 />}
49+
title="Developers"
50+
href="/docs/developers"
51+
description="Guides for writing plugins, creating custom widgets, and using the CLI tools."
6852
/>
6953
</Cards>
7054

71-
## Quick Links
72-
73-
### Essential Guides
74-
- **[Field Types](/docs/guides/field-types)** - 35 field types with examples (text, number, select, lookup, formula, etc.)
75-
- **[View Configuration](/docs/guides/view-configuration)** - Grid, Kanban, Calendar, Gantt, and Form layouts
76-
- **[Workflows & Validation](/docs/guides/workflows-validation)** - Business rules and automation
77-
- **[Project Structure](/docs/guides/project-structure)** - Best practices for organizing your code
78-
79-
### Examples
80-
- **[CRM Example](https://github.com/objectstack-ai/spec/tree/main/examples/crm)** - Full-featured application with 6 objects, workflows, views, dashboards
81-
- **[Todo Example](https://github.com/objectstack-ai/spec/tree/main/examples/todo)** - Quick-start minimal example
82-
83-
## The "Trinity" Architecture
84-
85-
ObjectStack is built on five core modules that work in unison:
55+
## Why ObjectStack?
8656

8757
| Module | Protocol | Responsibility |
8858
| :--- | :--- | :--- |
89-
| **Data Layer** | **[ObjectQL](/docs/specifications/data/architecture)** | Defines the shape of data (`Object`, `Field`) and how to access it (`Query AST`). Agnostic to SQL/NoSQL. |
90-
| **UI Layer** | **[ObjectUI](/docs/specifications/ui/sdui-protocol)** | The Projection. Defines User Interfaces as abstract JSON layouts (Views, Dashboards, Actions). |
91-
| **Control Layer** | **[ObjectOS](/docs/specifications/server/kernel-architecture)** | The Kernel. Handles Identity, Security, Sync, and Automation. |
92-
| **AI Layer** | **AI Protocol** | AI agent definitions, tools, knowledge bases, and model configurations. |
93-
| **API Layer** | **API Protocol** | Standardized REST/GraphQL contracts with request/response envelopes. |
59+
| **Data Layer** | **[ObjectQL](/docs/objectql)** | Defines the shape of data (`Object`, `Field`) and how to access it. Agnostic to SQL/NoSQL. |
60+
| **UI Layer** | **[ObjectUI](/docs/objectui)** | The Projection. Defines User Interfaces as abstract JSON layouts (Views, Forms). |
61+
| **System Layer** | **[ObjectOS](/docs/objectos)** | The Kernel. Handles Identity, Security, Sync, and Lifecycle. |
9462

9563
## For whom is this?
9664

0 commit comments

Comments
 (0)