diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..907b1ad
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,39 @@
+
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
+
+
+# AOSSIE Webpage Starter
+
+Project specific context and directives for AI agents.
+
+## 🛠️ Stack & Commands
+
+- **Stack:** Next.js 16.2.11 App Router (Turbopack), React 19, Tailwind CSS v4, `next-intl` (i18n), `next-themes` (light/dark state manager).
+- **Build:** `npm run build`
+- **Develop:** `npm run dev`
+
+---
+
+## 🎨 Styles & Theme System
+
+- **Class-Based Dark Mode:** Tailwind CSS v4 is configured for class-based overrides using `@custom-variant dark (&:where(.dark, .dark *))` in [`globals.css`](src/app/[locale]/globals.css).
+- **Semantic Tokens:** Do **not** write inline layout dark utilities (e.g., `dark:bg-black` or `dark:text-zinc-50`). Always write semantic classes linked to the central theme variables (e.g., `bg-background-primary`, `text-foreground-primary`).
+- **Typography:** The default font family is **Inter**. It is mapped to `--font-sans` in globals.css.
+
+---
+
+## 🌐 i18n & l10n Routing
+
+- **Dynamic segment:** All localized pages and layouts must be nested inside [`src/app/[locale]/`](src/app/[locale]/).
+- **Awaiting params:** Layout and Page `params` props are Promises in Next.js 15/16. Always `await params` before accessing `locale`.
+- **Navigation:** Never import `Link`, `useRouter`, or `usePathname` from standard `next/link` or `next/navigation`. Always import them from local configuration helpers in [`src/i18n/navigation.ts`](src/i18n/navigation.ts).
+
+---
+
+## 📦 Project Boundaries
+
+- **Config alias map:** Webpack & Turbopack alias resolvers are manually defined in [`next.config.ts`](next.config.ts) mapping `"next-intl/config"` to our local request setup. Do not import the native `@swc/core` compiler plugin wrapper `createNextIntlPlugin` directly to avoid security policy native module blocks.
+- **Branding Assets:** The official branding logo, favicon, and style specifications reside inside [`brand/`](brand/).
+
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..43c994c
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md
diff --git a/README.md b/README.md
index 64c32c1..306284f 100644
--- a/README.md
+++ b/README.md
@@ -3,8 +3,9 @@
@@ -12,177 +13,355 @@
-[](https://TODO.stability.nexus/)
-
-
+[](https://aossie.org/)
-
+
-
-
+
+
-
+
+
+
+
-
-
-
-
-
+
+
-
+
+
+
-
+
+
---
-
TODO: Project Name
+TODO: Project Name (AOSSIE Webpage Starter)
-[TODO](https://TODO.stability.nexus/) is a ... TODO: Project Description.
+[TODO](https://TODO.aossie.org/) is a ... TODO: Project Description.
+
+A high-performance, developer-friendly webpage starter kit built on **Next.js 16 (App Router)**, **React 19**, **Tailwind CSS v4**, and pre-configured for **Internationalization (i18n)** and **Localization (l10n)** using **next-intl**.
+
+This starter is designed for organizations looking to kickstart their web presence with a fully accessible, multi-lingual, and responsive architecture out-of-the-box.
---
-## Project Maturity
-
-TODO: In the checklist below, mark the items that have been completed and delete items that are not applicable to the current project:
-
-* [ ] The project has a logo.
-* [ ] The project has a favicon.
-* [ ] The protocol:
- - [ ] has been described and formally specified in a paper.
- - [ ] has had its main properties mathematically proven.
- - [ ] has been formally verified.
-* [ ] The smart contracts:
- - [ ] were thoroughly reviewed by at least two knights of The Stable Order.
- - [ ] were deployed to:
- - [ ] Ergo
- - [ ] Cardano
- - [ ] EVM Chains:
- - [ ] Ethereum Classic
- - [ ] Ethereum
- - [ ] Polygon
- - [ ] BSC
- - [ ] Base
-* [ ] The mobile app:
- - [ ] has an _About_ page containing the Stability Nexus's logo and pointing to the social media accounts of the Stability Nexus.
- - [ ] is available for download as a release in this repo.
- - [ ] is available in the relevant app stores.
-* [ ] The web frontend:
- - [ ] has proper title and metadata.
- - [ ] has proper open graph metadata, to ensure that it is shown well when shared in social media (Discord, Telegram, Twitter, LinkedIn).
- - [ ] has a footer, containing the Stability Nexus's logo and pointing to the social media accounts of the Stability Nexus.
- - [ ] is fully static and client-side.
- - [ ] is deployed to Github Pages via a Github Workflow.
- - [ ] is accessible through the https://TODO:PROJECT-NAME.stability.nexus domain.
-* [ ] the project is listed in [https://stability.nexus/protocols](https://stability.nexus/protocols).
+## 🚀 Features
+
+TODO: List your main features here:
+
+- **Feature 1**: Description
+- **Feature 2**: Description
+- **Feature 3**: Description
+- **Feature 4**: Description
---
-## Tech Stack
+## 💻 Tech Stack
+
+TODO: Update based on your project
+
+---
-TODO:
+## 📋 Project Maturity & TODO Checklist
-### Frontend
+In the checklist below, mark the items that have been completed for your project:
-TODO:
+* [x] The project has a logo (`brand/logo.svg`).
+* [x] The project has a favicon (`brand/favicon.ico`).
+* [x] The web frontend:
+ - [x] Has proper title and metadata.
+ - [x] Has proper open graph metadata, to ensure that it is shown well when shared in social media.
+ - [x] Has a footer and header with AOSSIE logos and social handles.
+ - [x] Is client-side rendered (`"use client"` configured for pages).
+ - [x] Is deployed to GitHub Pages via a GitHub Workflow (`.github/workflows/nextjs.yml`).
+ - [x] Has automated CI build and lint validation (`.github/workflows/ci.yml`).
+ - [x] Has CodeRabbit automated AI code review (`.coderabbit.yml`).
+ - [x] Has open-source legal compliance (`DCO.md`, `COPYRIGHT.md`, `Contributors.md`).
-- Next.js 14+ (React)
-- TypeScript
-- TailwindCSS
-- shadcn/ui
+---
-### Blockchain
+## 🚀 Key Features
+
+- **Next.js 16 & React 19:** Utilizing the latest Server Components, Client Actions, and async routing paradigms.
+- **Tailwind CSS v4:** Modern utility-first styling with native CSS variables and streamlined postcss integrations.
+- **Dual Theme System:** Flash-free light, dark, and system preferred themes using `next-themes` and Tailwind CSS v4 custom variants.
+- **Robust i18n & l10n:** Deeply integrated multi-language support:
+ - Automatic locale detection based on browser preferences.
+ - Subpath routing (e.g., `/en`, `/hi`) with clean `as-needed` URL prefixing.
+ - Sleek, interactive language switcher client component.
+ - Zero-bundle-size footprint for static translations using Server Components & Client `useTranslations`.
+- **Developer Experience:** Strict TypeScript compilation and ES Lint setup.
+- **Application Control Compatibility:** Configured with manual Webpack & Turbopack alias resolution to bypass restrictive execution environments blocking native binary compiles.
+- **Open-Source Governance & CI/CD:** Integrated GitHub Actions workflows (`ci.yml`, `nextjs.yml`, `label-merge-conflicts.yml`), `.coderabbit.yml`, and `DCO.md` legal documentation.
+- **AI Agent Pairing Ready:** Includes `AGENTS.md` and `CLAUDE.md` to guide AI development agents.
-TODO:
+---
-- Wagmi
-- Solidity Smart Contracts
-- Ethers.js
+## 📂 Project Structure
+
+Here is a breakdown of the key i18n directories and files:
+
+```text
+├── .github/
+│ └── workflows/ # GitHub Actions (CI, GitHub Pages deployment, merge conflict checks)
+├── brand/
+│ ├── logo.svg # Vector logo
+│ ├── favicon.ico # Browser tab icon
+│ └── Brand.md # Official AOSSIE brand guidelines document
+├── next.config.ts # Alias-wrapped Next configuration
+├── public/ # Static assets, robots.txt, assetlinks.json, llms.txt
+├── src/
+│ ├── config/
+│ │ └── languages.ts # Central registry of supported languages & locales
+│ ├── i18n/
+│ │ ├── routing.ts # Core i18n routing parameters (locales, defaults)
+│ │ ├── request.ts # Server-side translation dictionary loading configuration
+│ │ └── navigation.ts # Type-safe navigation helpers (Link, useRouter, etc.)
+│ ├── messages/
+│ │ ├── en.json # English translation dictionary
+│ │ └── hi.json # Hindi translation dictionary
+│ ├── app/
+│ │ ├── sitemap.ts # Dynamically generated localized sitemaps
+│ │ └── [locale]/ # Localized route group
+│ │ ├── layout.tsx # Multi-lingual layout injecting client context & translations
+│ │ ├── page.tsx # Localized Landing Page ("use client")
+│ │ ├── globals.css # Global styles for the app segment
+│ │ ├── error.tsx # Localized Error Boundary page fallback
+│ │ └── not-found.tsx # Localized 404 page fallback
+│ ├── components/
+│ │ ├── LanguageSwitcher.tsx # Dropdown element to switch interface locales interactively
+│ │ ├── ThemeToggle.tsx # Multi-state theme switch with micro-animations
+│ │ └── providers/
+│ │ ├── theme-provider.tsx # Next-themes client wrapper component
+│ │ └── lenis-provider.tsx # Lenis smooth scrolling provider wrapper
+│ └── proxy.ts # Next.js 16 Proxy Middleware for route and locale redirection
+├── .coderabbit.yml # Automated AI Code Review configuration
+├── COPYRIGHT.md # Copyright terms
+├── Contributors.md # Project contributors list
+└── DCO.md # Developer Certificate of Origin
+```
---
-## Getting Started
+## 🛠️ Usage Guide
+
+### 1. Adding a New Language
-### Prerequisites
+To add support for a new language (e.g., French - `fr`):
-TODO
+1. **Register the language:** Open [`src/config/languages.ts`](src/config/languages.ts) and add your new language to the `languages` array:
+ ```typescript
+ export const languages: Language[] = [
+ { code: 'en', name: 'English', localName: 'English' },
+ { code: 'hi', name: 'Hindi', localName: 'हिन्दी' },
+ { code: 'fr', name: 'French', localName: 'Français' } // Add this line
+ ];
+ ```
-- Node.js 18+
-- npm/yarn/pnpm
-- MetaMask or any other web3 wallet browser extension
+2. **Create the translation catalog:** Under `src/messages/`, create a new file named `fr.json`:
+ ```json
+ {
+ "Home": {
+ "heading": "Bienvenue sur AOSSIE Webpage Starter"
+ }
+ }
+ ```
-### Installation
+3. That's it! Next.js and `next-intl` will automatically register the locale, add it to the routing tables, and handle redirection for visitors matching `fr` browser preferences.
-TODO
+---
-#### 1. Clone the Repository
+### 2. Translating Text in Pages and Components
-```bash
-git clone https://github.com/StabilityNexus/TODO.git
-cd TODO
+#### Server Components (Recommended for Static Content)
+By default, server components can load translations statically without shipping translation JSONs to the client bundle:
+
+```tsx
+import { useTranslations } from 'next-intl';
+
+export default function Section() {
+ const t = useTranslations('Home');
+ return {t('heading')} ;
+}
+```
+
+#### Client Components
+If your component uses React hooks (e.g., `useState`), define it with `"use client"` and import from `next-intl`:
+
+```tsx
+"use client";
+
+import { useTranslations } from 'next-intl';
+
+export default function InteractiveButton() {
+ const t = useTranslations('Home');
+ return alert('Clicked!')}>{t('heading')} ;
+}
+```
+
+---
+
+### 3. Navigation Helpers
+
+When navigating between routes, always use the locale-aware navigation helpers imported from [`src/i18n/navigation.ts`](src/i18n/navigation.ts) instead of standard `next/link` or `next/navigation`:
+
+```tsx
+import { Link } from '../../i18n/navigation';
+
+// Will automatically resolve to /en/about or /hi/about based on active locale
+
+ This card automatically transitions colors across light and dark themes.
+
+```
+
+---
+
+### 5. Smooth Scrolling (Lenis)
+
+The starter repository integrates the `lenis` library to provide smooth, high-performance inertial scrolling across all browsers.
+
+#### Customizing Lenis Options
+To configure scroll parameters (e.g., dampening velocity, custom scroll durations, or scroll directions), update the parameters passed to the `ReactLenis` component in [`lenis-provider.tsx`](src/components/providers/lenis-provider.tsx):
+
+```tsx
+
+ {children}
+
+```
+
+To access the active Lenis instance or bind custom scroll animations programmatically in your page components, use the `useLenis` hook:
+
+```typescript
+import { useLenis } from 'lenis/react';
+
+const lenis = useLenis(({ scroll, limit, velocity, direction }) => {
+ // Bind your scroll logic or animation timelines here
+});
```
-#### 2. Install Dependencies
+---
+
+## ⚡ Development and Deployment
-Using your preferred package manager:
+### Getting Started
+Install the project dependencies:
```bash
npm install
-# or
-yarn install
-# or
-pnpm install
```
-#### 3. Run the Development Server
+Start the development server:
+```bash
+npm run dev
+```
-Start the app locally:
+Open [http://localhost:3000](http://localhost:3000) to view it. The application will automatically detect your browser's language preferences and route you to `/en` or `/hi` (or fall back to the default language, English).
+### Building for Production
+
+Compile and optimize the project:
```bash
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
+npm run build
+```
+
+This compiles optimized static pages under the `/[locale]` path and checks all TypeScript configurations.
+
+### Running in Production
+
+Start the optimized server:
+```bash
+npm run start
```
-#### 4. Open your Browser
+---
+
+## ⚙️ Initial Project Setup Checklist
+
+When bootstrapping a new project from this starter repository, update the following configurations to align with your project's branding, package naming, and hosting domains:
+
+### 1. Domain Names & Sitemap URL
+- **Sitemap Generator ([`src/app/sitemap.ts`](src/app/sitemap.ts))**: Replace the default fallback domain `https://project.aossie.org` with your project's production domain, or set the `NEXT_PUBLIC_SITE_URL` environment variable in your production hosting panel.
+- **Search Crawler Rules ([`public/robots.txt`](public/robots.txt))**: Replace the sitemap URL domain `https://project.aossie.org/sitemap.xml` with your production URL.
+
+### 2. Branding Guidelines & Assets
+- **Logo & Favicons ([`brand/`](brand/))**: Replace `logo.svg` and `favicon.ico` with your organization's custom logos. Copy these updated assets to the [`public/assets/icons/`](public/assets/icons/) directory as well (`public/assets/icons/aossie_logo.svg` and `public/assets/icons/favicon.ico`).
+- **Brand Documentation ([`brand/Brand.md`](brand/Brand.md))**: Document your custom color hex codes, typography selections, and asset paths here to guide future developers and AI coding agents.
+
+### 3. SEO Structured Data
+- **Schema.org JSON-LD ([`src/app/[locale]/page.tsx`](src/app/[locale]/page.tsx))**: Locate the `jsonLd` object inside the `Home` component. Replace the default publisher URLs and name fields with your specific project metadata.
+
+### 4. Mobile & AI Platform Configurations
+- **Android App Links ([`public/.well-known/assetlinks.json`](public/.well-known/assetlinks.json))**: Change the package name `org.aossie.starter` and insert your Android application certificate SHA-256 fingerprint to handle incoming domain links on mobile.
+- **AI Agent Plugins ([`public/.well-known/ai-plugin.json`](public/.well-known/ai-plugin.json))**: Update the host URLs, contact emails, and description text to describe your final website's features to AI agents.
+- **LLM Crawler Rules ([`public/llms.txt`](public/llms.txt))**: Serves the root crawlers policy indicating allowing LLM bot indexing. Update if you wish to block specific AI search engines.
-Navigate to [http://localhost:3000](http://localhost:3000) to see the application.
---
-## Contributing
+## 🤝 Contributing
We welcome contributions of all kinds! To contribute:
1. Fork the repository and create your feature branch (`git checkout -b feature/AmazingFeature`).
2. Commit your changes (`git commit -m 'Add some AmazingFeature'`).
-3. Run the development workflow commands to ensure code quality:
- - `npm run format:write`
- - `npm run lint:fix`
- - `npm run typecheck`
+3. Ensure code quality:
+ - `npm run lint`
+ - `npm run build`
4. Push your branch (`git push origin feature/AmazingFeature`).
5. Open a Pull Request for review.
-If you encounter bugs, need help, or have feature requests:
-
-- Please open an issue in this repository providing detailed information.
-- Describe the problem clearly and include any relevant logs or screenshots.
-
-We appreciate your feedback and contributions!
-
-© 2025 The Stable Order.
+© 2025 AOSSIE. Released under the Apache 2.0 / Open Source License.
diff --git a/app/favicon.ico b/app/favicon.ico
deleted file mode 100644
index 718d6fe..0000000
Binary files a/app/favicon.ico and /dev/null differ
diff --git a/app/globals.css b/app/globals.css
deleted file mode 100644
index a2dc41e..0000000
--- a/app/globals.css
+++ /dev/null
@@ -1,26 +0,0 @@
-@import "tailwindcss";
-
-:root {
- --background: #ffffff;
- --foreground: #171717;
-}
-
-@theme inline {
- --color-background: var(--background);
- --color-foreground: var(--foreground);
- --font-sans: var(--font-geist-sans);
- --font-mono: var(--font-geist-mono);
-}
-
-@media (prefers-color-scheme: dark) {
- :root {
- --background: #0a0a0a;
- --foreground: #ededed;
- }
-}
-
-body {
- background: var(--background);
- color: var(--foreground);
- font-family: Arial, Helvetica, sans-serif;
-}
diff --git a/app/layout.tsx b/app/layout.tsx
deleted file mode 100644
index f7fa87e..0000000
--- a/app/layout.tsx
+++ /dev/null
@@ -1,34 +0,0 @@
-import type { Metadata } from "next";
-import { Geist, Geist_Mono } from "next/font/google";
-import "./globals.css";
-
-const geistSans = Geist({
- variable: "--font-geist-sans",
- subsets: ["latin"],
-});
-
-const geistMono = Geist_Mono({
- variable: "--font-geist-mono",
- subsets: ["latin"],
-});
-
-export const metadata: Metadata = {
- title: "Create Next App",
- description: "Generated by create next app",
-};
-
-export default function RootLayout({
- children,
-}: Readonly<{
- children: React.ReactNode;
-}>) {
- return (
-
-
- {children}
-
-
- );
-}
diff --git a/app/page.tsx b/app/page.tsx
deleted file mode 100644
index 295f8fd..0000000
--- a/app/page.tsx
+++ /dev/null
@@ -1,65 +0,0 @@
-import Image from "next/image";
-
-export default function Home() {
- return (
-
-
-
-
- To get started, edit the page.tsx file.
-
-
- Looking for a starting point or more instructions? Head over to{" "}
-
- Templates
- {" "}
- or the{" "}
-
- Learning
- {" "}
- center.
-
-
-
+
+
+
+
+
+ {t("title")}
+
+
+ {t("description")}
+
+
+
+
+ {t("retry")}
+
+
+
+
+
+ {children}
+
+
+
+
+
+ );
+}
diff --git a/src/app/[locale]/not-found.tsx b/src/app/[locale]/not-found.tsx
new file mode 100644
index 0000000..cb5e38b
--- /dev/null
+++ b/src/app/[locale]/not-found.tsx
@@ -0,0 +1,46 @@
+import { useTranslations } from "next-intl";
+import { Link } from "../../i18n/navigation";
+
+export default function NotFound() {
+ const t = useTranslations("NotFound");
+
+ return (
+
+
+
+
+
+
+ {t("title")}
+
+
+ {t("description")}
+
+
+
+
+ {t("home")}
+
+
+
+ {/* Schema.org JSON-LD Structured Data */}
+
+
+
+
+
+ {t("heading")}
+
+
+
+
+
+
+
+ {t("label")}:
+
+
+ handleLanguageChange(e.target.value)}
+ className="rounded-md border border-border-default bg-background-secondary px-3 py-1.5 text-sm text-foreground-primary shadow-sm focus:border-foreground-primary focus:outline-none focus:ring-1 focus:ring-foreground-primary cursor-pointer"
+ >
+ {languages.map((lang) => (
+
+ {lang.localName} ({lang.name})
+
+ ))}
+
+
+ );
+}
diff --git a/src/components/ThemeToggle.tsx b/src/components/ThemeToggle.tsx
new file mode 100644
index 0000000..d1b12f3
--- /dev/null
+++ b/src/components/ThemeToggle.tsx
@@ -0,0 +1,87 @@
+"use client";
+
+import { useTheme } from "next-themes";
+import { useEffect, useState } from "react";
+import { useTranslations } from "next-intl";
+
+export default function ThemeToggle() {
+ const { theme, setTheme } = useTheme();
+ const t = useTranslations("ThemeToggle");
+ const [mounted, setMounted] = useState(false);
+
+ // Prevent hydration mismatch by waiting for mount
+ useEffect(() => {
+ const handle = requestAnimationFrame(() => setMounted(true));
+ return () => cancelAnimationFrame(handle);
+ }, []);
+
+ if (!mounted) {
+ return
;
+ }
+
+ const toggleTheme = () => {
+ if (theme === "light") setTheme("dark");
+ else if (theme === "dark") setTheme("system");
+ else setTheme("light");
+ };
+
+ return (
+
+ {theme === "light" && (
+
+
+ )}
+
+ {theme === "dark" && (
+
+
+ )}
+
+ {theme === "system" && (
+
+
+ )}
+
+ );
+}
diff --git a/src/components/providers/lenis-provider.tsx b/src/components/providers/lenis-provider.tsx
new file mode 100644
index 0000000..235def1
--- /dev/null
+++ b/src/components/providers/lenis-provider.tsx
@@ -0,0 +1,40 @@
+"use client";
+
+import type { ReactNode } from "react";
+import { useSyncExternalStore } from "react";
+import { ReactLenis } from "lenis/react";
+import "lenis/dist/lenis.css";
+
+function subscribeReducedMotion(callback: () => void) {
+ const mediaQuery = window.matchMedia("(prefers-reduced-motion: reduce)");
+ mediaQuery.addEventListener("change", callback);
+ return () => mediaQuery.removeEventListener("change", callback);
+}
+
+function getSnapshot() {
+ return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+
+function getServerSnapshot() {
+ return false;
+}
+
+export function LenisProvider({ children }: { children: ReactNode }) {
+ const prefersReducedMotion = useSyncExternalStore(
+ subscribeReducedMotion,
+ getSnapshot,
+ getServerSnapshot
+ );
+
+ if (prefersReducedMotion) {
+ return <>{children};
+ }
+
+ return (
+
+ {children}
+
+ );
+}
+
+
diff --git a/src/components/providers/theme-provider.tsx b/src/components/providers/theme-provider.tsx
new file mode 100644
index 0000000..d466f8e
--- /dev/null
+++ b/src/components/providers/theme-provider.tsx
@@ -0,0 +1,15 @@
+"use client";
+
+import { ThemeProvider as NextThemesProvider } from "next-themes";
+import type { ComponentProps } from "react";
+
+export function ThemeProvider({
+ children,
+ ...props
+}: ComponentProps) {
+ return (
+
+ {children}
+
+ );
+}
diff --git a/src/config/languages.ts b/src/config/languages.ts
new file mode 100644
index 0000000..f6e90f3
--- /dev/null
+++ b/src/config/languages.ts
@@ -0,0 +1,15 @@
+export interface Language {
+ code: string;
+ name: string;
+ localName: string;
+}
+
+export const languages = [
+ { code: 'en', name: 'English', localName: 'English' },
+ { code: 'hi', name: 'Hindi', localName: 'हिन्दी' },
+] as const satisfies readonly Language[];
+
+export type Locale = (typeof languages)[number]['code'];
+
+export const defaultLanguage: Locale = 'en';
+
diff --git a/src/i18n/metadata.ts b/src/i18n/metadata.ts
new file mode 100644
index 0000000..042963e
--- /dev/null
+++ b/src/i18n/metadata.ts
@@ -0,0 +1,49 @@
+import { getTranslations } from 'next-intl/server';
+import type { Metadata } from 'next';
+
+export async function generateLocaleMetadata(
+ locale: string,
+ namespace: string
+): Promise {
+ const t = await getTranslations({ locale, namespace });
+
+ const rawSiteUrl = process.env.NEXT_PUBLIC_SITE_URL || 'https://project.aossie.org';
+ const siteUrl = rawSiteUrl.replace(/\/$/, '');
+ const localeUrl = locale === 'en' ? siteUrl : `${siteUrl}/${locale}`;
+
+
+ return {
+ title: t('metaTitle'),
+ description: t('metaDescription'),
+ alternates: {
+ canonical: localeUrl,
+ languages: {
+ en: siteUrl,
+ hi: `${siteUrl}/hi`,
+ },
+ },
+ openGraph: {
+ title: t('metaTitle'),
+ description: t('metaDescription'),
+ url: localeUrl,
+
+ siteName: 'AOSSIE',
+ images: [
+ {
+ url: `${siteUrl}/assets/icons/aossie_logo.svg`,
+ width: 500,
+ height: 500,
+ alt: 'AOSSIE Logo',
+ },
+ ],
+ locale: locale === 'en' ? 'en_US' : 'hi_IN',
+ type: 'website',
+ },
+ twitter: {
+ card: 'summary_large_image',
+ title: t('metaTitle'),
+ description: t('metaDescription'),
+ images: [`${siteUrl}/assets/icons/aossie_logo.svg`],
+ },
+ };
+}
diff --git a/src/i18n/navigation.ts b/src/i18n/navigation.ts
new file mode 100644
index 0000000..a10a415
--- /dev/null
+++ b/src/i18n/navigation.ts
@@ -0,0 +1,4 @@
+import { createNavigation } from 'next-intl/navigation';
+import { routing } from './routing';
+
+export const { Link, redirect, usePathname, useRouter } = createNavigation(routing);
diff --git a/src/i18n/request.ts b/src/i18n/request.ts
new file mode 100644
index 0000000..c21b424
--- /dev/null
+++ b/src/i18n/request.ts
@@ -0,0 +1,16 @@
+import { getRequestConfig } from 'next-intl/server';
+import { routing } from './routing';
+
+export default getRequestConfig(async ({ requestLocale }) => {
+ let locale = await requestLocale;
+
+ // Ensure the locale is valid
+ if (!locale || !routing.locales.includes(locale as (typeof routing.locales)[number])) {
+ locale = routing.defaultLocale;
+ }
+
+ return {
+ locale,
+ messages: (await import(`../messages/${locale}.json`)).default,
+ };
+});
diff --git a/src/i18n/routing.ts b/src/i18n/routing.ts
new file mode 100644
index 0000000..e39fc66
--- /dev/null
+++ b/src/i18n/routing.ts
@@ -0,0 +1,8 @@
+import { defineRouting } from 'next-intl/routing';
+import { languages, defaultLanguage } from '../config/languages';
+
+export const routing = defineRouting({
+ locales: languages.map((lang) => lang.code),
+ defaultLocale: defaultLanguage,
+ localePrefix: 'as-needed',
+});
diff --git a/src/messages/en.json b/src/messages/en.json
new file mode 100644
index 0000000..83e9879
--- /dev/null
+++ b/src/messages/en.json
@@ -0,0 +1,24 @@
+{
+ "Home": {
+ "heading": "Aossie Webpage Starter",
+ "metaTitle": "Aossie Webpage Starter - Multi-lingual Next.js 16 Template",
+ "metaDescription": "A starter template for Aossie portals featuring next-intl i18n/l10n and next-themes light/dark theme switcher."
+ },
+ "Error": {
+ "title": "Something went wrong",
+ "description": "An unexpected server or client error occurred while rendering the page.",
+ "retry": "Try again"
+ },
+ "NotFound": {
+ "title": "Page not found",
+ "description": "The page you are looking for does not exist or has been moved.",
+ "home": "Go to Home"
+ },
+ "LanguageSwitcher": {
+ "label": "Language"
+ },
+ "ThemeToggle": {
+ "toggleTheme": "Toggle theme"
+ }
+}
+
diff --git a/src/messages/hi.json b/src/messages/hi.json
new file mode 100644
index 0000000..4626c49
--- /dev/null
+++ b/src/messages/hi.json
@@ -0,0 +1,24 @@
+{
+ "Home": {
+ "heading": "ऑसी वेबपेज स्टार्टर",
+ "metaTitle": "ऑसी वेबपेज स्टार्टर - बहुभाषी नेक्स्ट.जेएस 16 टेम्पलेट",
+ "metaDescription": "ऑसी पोर्टल्स के लिए एक स्टार्टर टेम्पलेट जिसमें next-intl i18n/l10n और next-themes लाइट/डार्क थीम स्विचर शामिल हैं।"
+ },
+ "Error": {
+ "title": "कुछ गलत हो गया",
+ "description": "पेज रेंडर करते समय एक अप्रत्याशित त्रुटि आई है।",
+ "retry": "पुनः प्रयास करें"
+ },
+ "NotFound": {
+ "title": "पेज नहीं मिला",
+ "description": "जिस पेज को आप ढूंढ रहे हैं वह मौजूद नहीं है या हटा दिया गया है।",
+ "home": "होम पेज पर जाएं"
+ },
+ "LanguageSwitcher": {
+ "label": "भाषा"
+ },
+ "ThemeToggle": {
+ "toggleTheme": "थीम बदलें"
+ }
+}
+
diff --git a/src/proxy.ts b/src/proxy.ts
new file mode 100644
index 0000000..aab4cbb
--- /dev/null
+++ b/src/proxy.ts
@@ -0,0 +1,20 @@
+import type { NextRequest } from 'next/server';
+
+import createMiddleware from 'next-intl/middleware';
+import { routing } from './i18n/routing';
+
+const middleware = createMiddleware(routing);
+
+export function proxy(request: NextRequest) {
+ return middleware(request);
+}
+
+export const config = {
+ // Match only internationalized pathnames
+ matcher: [
+ // Match all pathnames except for public files, API, etc.
+ '/((?!api|_next|_vercel|.*\\..*).*)',
+ // Match all pathnames within `/`
+ '/',
+ ],
+};
diff --git a/tsconfig.json b/tsconfig.json
index 3a13f90..cf9c65d 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -19,7 +19,7 @@
}
],
"paths": {
- "@/*": ["./*"]
+ "@/*": ["./src/*"]
}
},
"include": [
- 
+ 
+ 
