docs: link official Agora resources

Author: 634750802

README.md

@@ -4,6 +4,13 @@ Reference implementation for building Agora realtime voice agents as Vercel apps
 
 Homepage: https://agora-realtime-agent.vercel.app/?utm_source=github&utm_medium=readme&utm_campaign=agora_voice_agents
 
+Official Agora resources:
+
+- Agora: https://www.agora.io/en/
+- Agora Docs (English): https://docs.agora.io/en/
+- Agora realtime voice docs: https://docs.agora.io/en/realtime-media/voice
+- Agora AI and Conversational AI docs: https://docs.agora.io/en/ai
+
 Research baseline: 2026-07-02.
 
 ## Current direction

apps/website/app/docs/agora-realtime-react-package/page.mdx

@@ -99,6 +99,10 @@ This boundary lets the same npm package power the hosted demo, the Vercel templa
 
 ## References
 
+- Agora: https://www.agora.io/en/
+- Agora Docs (English): https://docs.agora.io/en/
+- Agora realtime voice docs: https://docs.agora.io/en/realtime-media/voice
+- Agora AI and Conversational AI docs: https://docs.agora.io/en/ai
 - Vercel AI SDK docs: https://ai-sdk.dev/docs
 - Vercel environment variables: https://vercel.com/docs/environment-variables
 - Agora realtime hook: `packages/agora-realtime-react/src/use-agora-realtime.ts`

apps/website/app/docs/deploy-agent-pipeline/page.mdx

@@ -34,7 +34,7 @@ npm run dev
 
 ## 1. Create the Agora project
 
-In the Agora Console:
+In the [Agora Console](https://console.agora.io/):
 
 1. Create or select an Agora project.
 2. Copy the App ID.
@@ -133,6 +133,11 @@ That split keeps sensitive Agora credentials out of the browser while still givi
 
 ## References
 
+- Agora: https://www.agora.io/en/
+- Agora Docs (English): https://docs.agora.io/en/
+- Agora realtime voice docs: https://docs.agora.io/en/realtime-media/voice
+- Agora AI and Conversational AI docs: https://docs.agora.io/en/ai
+- Agora Console: https://console.agora.io/
 - Agora Agents SDK: `node_modules/agora-agents/README.md`
 - Template setup route: `templates/agora-agent-pipeline/app/api/agora/realtime/setup/route.ts`
 - Vercel monorepo deployment: https://vercel.com/docs/monorepos

apps/website/app/docs/install-voice-ring-with-shadcn/page.mdx

@@ -98,5 +98,8 @@ and:
 
 ## References
 
+- Agora: https://www.agora.io/en/
+- Agora Docs (English): https://docs.agora.io/en/
+- Agora realtime voice docs: https://docs.agora.io/en/realtime-media/voice
 - shadcn registry guide: https://ui.shadcn.com/docs/registry/getting-started
 - shadcn registry item schema: https://ui.shadcn.com/docs/registry/registry-item-json

apps/website/app/globals.css

@@ -466,6 +466,67 @@ h1 {
   color: #a7f6ff;
 }
 
+.official-resources {
+  border-top: 1px solid rgba(244, 239, 228, 0.12);
+  display: grid;
+  gap: clamp(1rem, 4vw, 3rem);
+  grid-template-columns: minmax(0, 0.86fr) minmax(0, 1.14fr);
+  margin: 0 auto;
+  max-width: 1180px;
+  padding: 4rem clamp(1rem, 4vw, 2rem) 5rem;
+  position: relative;
+  z-index: 1;
+}
+
+.resource-heading {
+  display: grid;
+  gap: 0.9rem;
+}
+
+.resource-heading h2 {
+  font-size: clamp(1.9rem, 4vw, 3.4rem);
+  line-height: 1;
+}
+
+.resource-heading p:not(.eyebrow) {
+  color: rgba(244, 239, 228, 0.72);
+  font-size: 1rem;
+  line-height: 1.68;
+}
+
+.resource-grid {
+  display: grid;
+  gap: 0.75rem;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+
+.resource-card {
+  border: 1px solid var(--site-border);
+  border-radius: 8px;
+  display: grid;
+  gap: 0.7rem;
+  min-height: 9.5rem;
+  padding: 1rem;
+}
+
+.resource-card:hover {
+  background: rgba(244, 239, 228, 0.06);
+  border-color: rgba(76, 238, 255, 0.34);
+}
+
+.resource-card span {
+  color: var(--site-cyan);
+  font-size: 0.84rem;
+  font-weight: 850;
+  text-transform: uppercase;
+}
+
+.resource-card p {
+  color: rgba(244, 239, 228, 0.72);
+  font-size: 0.94rem;
+  line-height: 1.58;
+}
+
 .docs-shell {
   min-height: 100svh;
   overflow-x: hidden;
@@ -751,14 +812,19 @@ h1 {
   .template-section,
   .journey-section,
   .docs-layout,
-  .voice-doc-preview {
+  .voice-doc-preview,
+  .official-resources {
     grid-template-columns: 1fr;
   }
 
   .pipeline-section {
     padding-bottom: 3rem;
   }
 
+  .resource-grid {
+    grid-template-columns: 1fr;
+  }
+
   .docs-sidebar {
     position: static;
   }

apps/website/app/page.tsx

@@ -34,6 +34,29 @@ const uiChecklist = [
   'Feed human and AI levels from useVoiceMeter or your own audio analysis.',
 ];
 
+const officialResources = [
+  {
+    href: 'https://www.agora.io/en/',
+    label: 'Agora',
+    text: 'Official Agora homepage for realtime engagement and AI products.',
+  },
+  {
+    href: 'https://docs.agora.io/en/',
+    label: 'Agora Docs',
+    text: 'English documentation hub for Agora product setup, SDKs, and APIs.',
+  },
+  {
+    href: 'https://docs.agora.io/en/realtime-media/voice',
+    label: 'Realtime voice docs',
+    text: 'Voice calling docs for the RTC media layer used by browser sessions.',
+  },
+  {
+    href: 'https://docs.agora.io/en/ai',
+    label: 'AI and Conversational AI docs',
+    text: 'Agora AI docs for agent pipelines, model configuration, and runtime concepts.',
+  },
+];
+
 export default function HomePage() {
   return (
     <main className="site-shell">
@@ -47,6 +70,7 @@ export default function HomePage() {
           <a href="#package">Package</a>
           <a href="#deploy">Deploy</a>
           <a href="#ui">UI</a>
+          <a href="#resources">Resources</a>
         </nav>
       </header>
 
@@ -121,6 +145,24 @@ AGORA_CONVOAI_PIPELINE_ID=...`}</code></pre>
           <a className="text-link" href="/docs/install-voice-ring-with-shadcn">Read shadcn guide</a>
         </article>
       </section>
+
+      <section className="official-resources" id="resources" aria-labelledby="resources-title">
+        <div className="resource-heading">
+          <p className="eyebrow">Official references</p>
+          <h2 id="resources-title">Build against Agora's English docs.</h2>
+          <p>
+            This project packages the Vercel and React path. Use Agora's official site and English documentation for product setup, RTC behavior, and AI agent configuration details.
+          </p>
+        </div>
+        <div className="resource-grid">
+          {officialResources.map((resource) => (
+            <a className="resource-card" href={resource.href} key={resource.href} rel="noreferrer" target="_blank">
+              <span>{resource.label}</span>
+              <p>{resource.text}</p>
+            </a>
+          ))}
+        </div>
+      </section>
     </main>
   );
 }

apps/website/app/r/registry-data.ts

@@ -5,7 +5,7 @@ export const registryCatalog = {
     {
       categories: ['voice', 'realtime', 'agent', 'vercel'],
       description: 'A canvas-rendered voice ring button for Agora voice agents in Vercel and React apps.',
-      docs: 'Install with `npx shadcn@latest add https://agora-realtime-agent.vercel.app/r/voice-ring-button.json`, then import `VoiceRingButton` and `useVoiceMeter` from your shadcn aliases. Homepage: https://agora-realtime-agent.vercel.app/?utm_source=shadcn-registry&utm_medium=registry-item-docs&utm_campaign=agora_voice_agents',
+      docs: 'Install with `npx shadcn@latest add https://agora-realtime-agent.vercel.app/r/voice-ring-button.json`, then import `VoiceRingButton` and `useVoiceMeter` from your shadcn aliases. Homepage: https://agora-realtime-agent.vercel.app/?utm_source=shadcn-registry&utm_medium=registry-item-docs&utm_campaign=agora_voice_agents. Official Agora docs: https://docs.agora.io/en/',
       files: [
         {
           path: 'packages/agora-realtime-react/src/components/voice-ring-button.tsx',

packages/agora-realtime-react/README.md

@@ -54,3 +54,7 @@ The package does not store Agora credentials and does not publish AI Studio pipe
 
 - Package guide: https://agora-realtime-agent.vercel.app/docs/agora-realtime-react-package
 - Demo and Vercel template: https://agora-realtime-agent.vercel.app/?utm_source=npm-agora-realtime-react&utm_medium=readme-docs&utm_campaign=agora_voice_agents
+- Agora: https://www.agora.io/en/
+- Agora Docs (English): https://docs.agora.io/en/
+- Agora realtime voice docs: https://docs.agora.io/en/realtime-media/voice
+- Agora AI and Conversational AI docs: https://docs.agora.io/en/ai

packages/create-agora-realtime-agent/README.md

@@ -6,6 +6,13 @@ Create an Agora + Vercel realtime voice agent app from the official template.
 
 Homepage: https://agora-realtime-agent.vercel.app/?utm_source=npm-create-agora-realtime-agent&utm_medium=readme&utm_campaign=agora_voice_agents
 
+Official Agora resources:
+
+- Agora: https://www.agora.io/en/
+- Agora Docs (English): https://docs.agora.io/en/
+- Agora realtime voice docs: https://docs.agora.io/en/realtime-media/voice
+- Agora AI and Conversational AI docs: https://docs.agora.io/en/ai
+
 ## Usage
 
 ```bash

packages/create-agora-realtime-agent/template/README.md

@@ -4,6 +4,13 @@ This app was generated from the Agora realtime voice agent template.
 
 Project homepage: https://agora-realtime-agent.vercel.app/?utm_source=create-agora-realtime-agent&utm_medium=generated-template&utm_campaign=agora_voice_agents
 
+Official Agora resources:
+
+- Agora: https://www.agora.io/en/
+- Agora Docs (English): https://docs.agora.io/en/
+- Agora realtime voice docs: https://docs.agora.io/en/realtime-media/voice
+- Agora AI and Conversational AI docs: https://docs.agora.io/en/ai
+
 ## Requirements
 
 - Node.js compatible with Next.js 16. This template is tested from Node.js `>=20.9.0`; the source repo uses Node.js `>=24.0.0`.