Skip to content

[WIP] Add support for default language configuration#18

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hotlong merged 2 commits into from
Jan 19, 2026
Merged

[WIP] Add support for default language configuration #18

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1286a8c
Initial plan
Copilot Jan 19, 2026
444c8b1
Add i18n configuration and restructure app for multilingual support
Copilot Jan 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions apps/docs/app/docs/[[...slug]]/page.tsx → ...docs/app/[lang]/docs/[[...slug]]/page.tsx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -17,10 +17,10 @@ const components = {
};

export default async function Page(props: {
params: Promise<{ slug?: string[] }>;
params: Promise<{ lang: string; slug?: string[] }>;
}) {
const params = await props.params;
const page = await source.getPage(params.slug ?? []);
const page = source.getPage(params.slug ?? [], params.lang);
if (!page) notFound();

const data = page.data as any;
Expand All@@ -46,10 +46,10 @@ export async function generateStaticParams() {
}

export async function generateMetadata(props: {
params: Promise<{ slug?: string[] }>;
params: Promise<{ lang: string; slug?: string[] }>;
}): Promise<Metadata> {
const params = await props.params;
const page = await source.getPage(params.slug ?? []);
const page = source.getPage(params.slug ?? [], params.lang);
if (!page) notFound();

return {
Expand Down
21 changes: 21 additions & 0 deletions apps/docs/app/[lang]/docs/layout.tsx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
import { source } from '@/app/source';
import type { Metadata } from 'next';
import { DocsLayout } from 'fumadocs-ui/layouts/docs';
import type { ReactNode } from 'react';
import { baseOptions } from '@/app/layout.config';

export default async function Layout({
params,
children,
}: {
params: Promise<{ lang: string }>;
children: ReactNode;
}) {
const { lang } = await params;
Comment on lines +12 to +14

CopilotAIJan 19, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The language parameter from the URL is used directly without validation against the supported languages defined in i18n configuration. Consider validating that the lang parameter is one of the supported languages (['en', 'cn']) and redirecting to the default language if an invalid language is provided.

Copilot uses AI. Check for mistakes.

return (
<DocsLayout tree={source.pageTree[lang]} {...baseOptions}>
{children}
</DocsLayout>
);
}
Comment on lines +7 to +21

CopilotAIJan 19, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The old docs layout included a generateMetadata function that is now missing in the new language-specific layout. This metadata (title template and description specific to the docs section) should be restored to maintain proper SEO and browser tab titles for documentation pages.

Copilot uses AI. Check for mistakes.
25 changes: 25 additions & 0 deletions apps/docs/app/[lang]/layout.tsx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
import type { ReactNode } from 'react';
import { RootProvider } from 'fumadocs-ui/provider/next';
import { i18n } from '@/lib/i18n';

export default async function LanguageLayout({
params,
children,
}: {
params: Promise<{ lang: string }>;
children: ReactNode;
}) {
const { lang } = await params;

CopilotAIJan 19, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The language parameter from the URL is used directly without validation against the supported languages defined in i18n configuration. Consider validating that the lang parameter is one of the supported languages (['en', 'cn']) and redirecting to the default language if an invalid language is provided.

Copilot uses AI. Check for mistakes.

return (
<html lang={lang} suppressHydrationWarning>
<body>
<RootProvider>{children}</RootProvider>
</body>
</html>
);
}

export async function generateStaticParams() {
return i18n.languages.map((lang) => ({ lang }));
}
191 changes: 191 additions & 0 deletions apps/docs/app/[lang]/page.tsx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,191 @@
import Link from 'next/link';
import { Database, FileJson, Layers, ShieldCheck, Zap, Globe, Cpu, LayoutTemplate, Bot } from 'lucide-react';
import { HomeLayout } from 'fumadocs-ui/layouts/home';
import { baseOptions } from '@/app/layout.config';

export default function HomePage() {
return (
<HomeLayout {...baseOptions}>
<main className="flex min-h-screen flex-col items-center justify-center text-center px-4 py-16 sm:py-24 md:py-32 overflow-hidden bg-background text-foreground selection:bg-primary/20">

{/* Hero Section */}
<div className="relative z-10 max-w-5xl space-y-8">
<div className="inline-flex items-center rounded-full border border-fd-primary/20 bg-fd-primary/5 px-3 py-1 text-sm text-fd-primary backdrop-blur-sm transition-colors hover:bg-fd-primary/10 hover:border-fd-primary/30">
<span className="flex h-2 w-2 rounded-full bg-fd-primary mr-2 animate-pulse"></span>
Protocol Specification v1.0
</div>

<h1 className="text-5xl font-extrabold tracking-tight sm:text-7xl md:text-8xl bg-gradient-to-br from-foreground via-foreground/90 to-fd-primary/60 bg-clip-text text-transparent pb-4">
The ObjectStack <br/> Protocol
</h1>

<p className="mx-auto max-w-2xl text-lg text-fd-muted-foreground sm:text-xl leading-relaxed">
The Open Standard for Metadata-Driven Enterprise Software.
<br className="hidden sm:inline" />
<span className="text-fd-foreground font-medium">Validatable. Database-Agnostic. AI-Native.</span>
</p>

<div className="flex flex-col sm:flex-row items-center justify-center gap-4 pt-4">
<Link
href="/docs/guides/getting-started"
className="inline-flex h-12 items-center justify-center rounded-lg bg-fd-primary px-8 text-sm font-medium text-fd-primary-foreground shadow-lg shadow-fd-primary/20 transition-all hover:bg-fd-primary/90 hover:scale-105 hover:shadow-fd-primary/30 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring disabled:pointer-events-none disabled:opacity-50"
>
Start Building
</Link>
<Link
href="/docs"
className="inline-flex h-12 items-center justify-center rounded-lg border border-fd-border bg-fd-card/50 px-8 text-sm font-medium shadow-sm transition-all hover:bg-fd-accent hover:text-fd-accent-foreground backdrop-blur-sm hover:scale-105 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring disabled:pointer-events-none disabled:opacity-50"
>
Read Specification
</Link>
</div>

{/* Code Preview Decorator */}
<div className="relative mx-auto mt-12 w-full max-w-3xl transform rounded-xlbg-gradient-to-br from-fd-border/50 to-fd-border/10 p-2 opacity-90 transition-all hover:scale-[1.01] hover:opacity-100 sm:mt-16">
<div className="overflow-hidden rounded-xl border border-fd-border bg-fd-card shadow-2xl">
<div className="flex items-center gap-2 border-b border-fd-border bg-fd-muted/50 px-4 py-3">
<div className="h-3 w-3 rounded-full bg-red-500/80" />
<div className="h-3 w-3 rounded-full bg-yellow-500/80" />
<div className="h-3 w-3 rounded-full bg-green-500/80" />
<div className="ml-2 text-xs font-medium text-fd-muted-foreground font-mono">
contract.zod.ts
</div>
</div>
<div className="overflow-x-auto p-6 text-left">
<pre className="font-mono text-sm leading-6">
<span className="text-purple-400">import</span> <span className="text-fd-foreground">{'{'}</span> <span className="text-yellow-300">ObjectProtocol</span> <span className="text-fd-foreground">{'}'}</span> <span className="text-purple-400">from</span> <span className="text-green-300">'@objectstack/spec'</span>;<br/><br/>
<span className="text-purple-400">export const</span> <span className="text-blue-300">Issue</span> <span className="text-purple-400">=</span> <span className="text-yellow-300">ObjectProtocol</span>.<span className="text-blue-300">define</span>(<span className="text-fd-foreground">{'{'}</span><br/>
&nbsp;&nbsp;code: <span className="text-green-300">'issue_tracker'</span>,<br/>
&nbsp;&nbsp;fields: <span className="text-fd-foreground">{'{'}</span><br/>
&nbsp;&nbsp;&nbsp;&nbsp;summary: <span className="text-yellow-300">Field</span>.<span className="text-blue-300">text</span>(<span className="text-fd-foreground">{'{'}</span> required: <span className="text-red-300">true</span> <span className="text-fd-foreground">{'}'}</span>),<br/>
&nbsp;&nbsp;&nbsp;&nbsp;priority: <span className="text-yellow-300">Field</span>.<span className="text-blue-300">select</span>([<span className="text-green-300">'P0'</span>, <span className="text-green-300">'P1'</span>, <span className="text-green-300">'P2'</span>]),<br/>
&nbsp;&nbsp;&nbsp;&nbsp;assignee: <span className="text-yellow-300">Field</span>.<span className="text-blue-300">lookup</span>(<span className="text-green-300">'users'</span>)<br/>
&nbsp;&nbsp;<span className="text-fd-foreground">{'}'}</span>,<br/>
&nbsp;&nbsp;policy: <span className="text-fd-foreground">{'{'}</span> <span className="text-blue-300">audit</span>: <span className="text-red-300">true</span>, <span className="text-blue-300">api_access</span>: <span className="text-green-300">'public'</span> <span className="text-fd-foreground">{'}'}</span><br/>
<span className="text-fd-foreground">{'}'}</span>);
</pre>
</div>
</div>
{/* Glow Effect behind Code */}
<div className="absolute -inset-4 -z-10 bg-fd-primary/20 blur-3xl opacity-30 rounded-[50%]" />
</div>
</div>

{/* Grid Pattern Background */}
<div className="absolute inset-0 -z-10 h-full w-full bg-[linear-gradient(to_right,#8080800a_1px,transparent_1px),linear-gradient(to_bottom,#8080800a_1px,transparent_1px)] bg-[size:4rem_4rem] [mask-image:radial-gradient(ellipse_60%_50%_at_50%_50%,#000_70%,transparent_100%)] pointer-events-none" />

{/* Feature Grid */}
<div className="mt-24 grid grid-cols-1 gap-8 text-left sm:grid-cols-2 lg:grid-cols-3 max-w-6xl w-full">
<FeatureCard
icon={<Database className="h-6 w-6" />}
title="ObjectQL Data Layer"
href="/docs/specifications/data/architecture"
description="Strict JSON schemas for entities, fields, and relationships. It is the SQL you can send over the wire."
/>
<FeatureCard
icon={<Layers className="h-6 w-6" />}
title="ObjectUI View Layer"
href="/docs/specifications/ui/sdui-protocol"
description="Server-Driven UI protocol defining forms, grids, and dashboards. Decouples logic from the frontend implementation."
/>
<FeatureCard
icon={<Zap className="h-6 w-6" />}
title="ObjectOS Kernel"
href="/docs/specifications/server/kernel-architecture"
description="The runtime contract for permissions, workflows, and automation. Stateless business logic execution."
/>
<FeatureCard
icon={<ShieldCheck className="h-6 w-6" />}
title="Zero-Trust Security"
href="/docs/specifications/server/permission-governance"
description="Policy-as-Code. ACLs and Field Level Security are compiled into the database query engine."
/>
<FeatureCard
icon={<FileJson className="h-6 w-6" />}
title="Zod-First Definition"
href="/docs/specifications/data/schema-definition"
description="The entire protocol is defined in Zod. Runtime validation and static type inference come for free."
/>
<FeatureCard
icon={<Globe className="h-6 w-6" />}
title="Universal Backend"
href="/docs/concepts/architecture"
description="Protocol adapters for Postgres, MongoDB, REST and GraphQL. Write once, run on any infrastructure."
/>
</div>

{/* Personas Section */}
<div className="mt-32 mb-16 w-full max-w-5xl px-4">
<h2 className="text-3xl font-bold tracking-tight mb-12 bg-gradient-to-r from-fd-foreground to-fd-muted-foreground bg-clip-text text-transparent">
Built for Builders
</h2>
<div className="grid grid-cols-1 md:grid-cols-3 gap-6">
<PersonaCard
icon={<LayoutTemplate className="w-8 h-8 mb-4 text-blue-500" />}
title="Platform Architects"
description="Design scalable Internal Developer Platforms (IDP) that unify your data silos."
href="/docs/concepts/enterprise-patterns"
action="Explore Patterns"
/>
<PersonaCard
icon={<Bot className="w-8 h-8 mb-4 text-purple-500" />}
title="AI Engineers"
description="Feed LLMs with perfectly structured, deterministic JSON schemas they can actually understand."
href="/docs/concepts/ai-codex"
action="View Codex"
/>
<PersonaCard
icon={<Cpu className="w-8 h-8 mb-4 text-green-500" />}
title="Framework Builders"
description="Implement the protocol in your language. Write drivers for React, Vue, Flutter, or Go."
href="/docs/specifications/data/architecture"
action="Read Spec"
/>
</div>
</div>

</main>
</HomeLayout>
);
}

function FeatureCard({ icon, title, description, href }: { icon: React.ReactNode; title: string; description: string; href?: string }) {
const CardContent = (
<div className="group relative h-full rounded-2xl border border-fd-border bg-fd-card p-6 shadow-sm transition-all hover:border-fd-primary/20 hover:shadow-md hover:shadow-fd-primary/5 cursor-pointer">
<div className="mb-4 inline-flex items-center justify-center rounded-lg bg-fd-primary/10 p-2 text-fd-primary transition-colors group-hover:bg-fd-primary/20">
{icon}
</div>
<h3 className="mb-2 text-lg font-semibold text-fd-card-foreground group-hover:text-fd-primary transition-colors">
{title}
</h3>
<p className="text-sm text-fd-muted-foreground leading-relaxed">
{description}
</p>
</div>
);

if (href) {
return (
<Link href={href} className="block h-full">
{CardContent}
</Link>
);
}

return CardContent;
}

function PersonaCard({ icon, title, description, href, action }: { icon: React.ReactNode; title: string; description: string; href: string; action: string }) {
return (
<Link href={href} className="flex flex-col items-start p-8 rounded-2xl bg-fd-secondary/30 border border-fd-border/50 hover:bg-fd-secondary/60 hover:border-fd-primary/30 transition-all group text-left">
{icon}
<h3 className="text-xl font-bold mb-3">{title}</h3>
<p className="text-fd-muted-foreground mb-6 text-sm leading-relaxed flex-grow text-left">
{description}
</p>
<div className="flex items-center text-sm font-semibold text-fd-primary mt-auto group-hover:translate-x-1 transition-transform">
{action} <span className="ml-1">→</span>
</div>
</Link>
)
}
23 changes: 0 additions & 23 deletions apps/docs/app/docs/layout.tsx
View file
Open in desktop

This file was deleted.

15 changes: 6 additions & 9 deletions apps/docs/app/layout.tsx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
import './global.css';
import { RootProvider } from 'fumadocs-ui/provider/next';
import { redirect } from 'next/navigation';

CopilotAIJan 19, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The unused import 'redirect' should be removed from this file. The import is declared but never used since the root layout only returns children without performing any redirect logic.

Suggested change
import { redirect } from 'next/navigation';

Copilot uses AI. Check for mistakes.
import type { ReactNode } from 'react';
import type { Metadata } from 'next';
import { i18n } from '@/lib/i18n';

CopilotAIJan 19, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The unused import 'i18n' should be removed from this file. The i18n configuration is imported but never used in the root layout.

Suggested change
import { i18n } from '@/lib/i18n';

Copilot uses AI. Check for mistakes.

export const metadata: Metadata = {
title: {
Expand All@@ -14,12 +15,8 @@ export const metadata: Metadata = {
},
};

export default function Layout({ children }: { children: ReactNode }) {
return (
<html lang="en" suppressHydrationWarning>
<body>
<RootProvider>{children}</RootProvider>
</body>
</html>
);
export default function RootLayout({ children }: { children: ReactNode }) {
// Root layout is only used for redirects with middleware
// The actual layout is in [lang]/layout.tsx
return children;

CopilotAIJan 19, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The root layout is missing the HTML structure (html and body tags). While the comment indicates this is intentional for middleware redirects, Next.js requires a proper HTML structure in the root layout. The layout should return a complete HTML document structure even if it's only used briefly before redirection.

Suggested change
returnchildren;
return(
<htmllang="en">
<body>{children}</body>
</html>
);

Copilot uses AI. Check for mistakes.
}
Loading
Loading