Skip to content

docs: comprehensive site overhaul with new pages and restructured navigation#7

Merged
0xharkirat merged 7 commits into
mainfrom
feat/docs-overhaul
Apr 11, 2026
Merged

docs: comprehensive site overhaul with new pages and restructured navigation#7
0xharkirat merged 7 commits into
mainfrom
feat/docs-overhaul

Conversation

@0xharkirat
Copy link
Copy Markdown
Contributor

Summary

  • 10 new pages: Try It Out, Add OACP to Your App, oacp.json Reference, Entity Providers, Wake Word, OACP Apps (ecosystem), Contributing Guide, AI Prompts, FAQ
  • 8 updated pages: index.mdx (hero rewrite), what-is-oacp (comparison table), getting-started (renamed to Integration Guide), overview (wake word + new apps), core-components (OacpActivity + entities), api-reference (full constants + new classes), roadmap (updated links), navigation JSON (restructured)
  • Navigation restructure: Introduction > Get Started > OACP Protocol > Hark > Android SDK > Ecosystem > Contributing > Resources
  • 1,333 lines added across 17 files

New pages highlight

  • AI Prompts (/ai-prompts/prompts): 5 copy-paste prompts for Claude/ChatGPT to help developers plan OACP integrations
  • oacp.json Reference (/oacp/oacp-json): complete schema reference with every field documented
  • FAQ: 12 questions covering compatibility, privacy, AppFunctions comparison, platform support

Test plan

  • npm run dev and verify all 27 pages render without errors
  • Check navigation sidebar order matches plan
  • Verify all internal links resolve (no 404s)
  • Check code blocks render with syntax highlighting
  • Verify Cloudflare Pages build passes

🤖 Generated with Claude Code

…navigation

Add Get Started section (Try It Out, Add OACP to Your App), protocol
reference pages (oacp.json schema, entity providers), Hark wake word docs,
ecosystem showcase, contributing guide, AI prompts for developers, and FAQ.

Restructure navigation: Introduction > Get Started > OACP Protocol > Hark >
Android SDK > Ecosystem > Contributing > Resources. Update existing pages
with comparison tables, OacpActivity/entity source coverage, and cross-links.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Apr 11, 2026

Deploying docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 52d5e33
Status:⚡️  Build in progress...

View logs

0xharkirat and others added 6 commits April 11, 2026 21:35
Home page: new hero ("MCP for mobile apps"), updated card grid (OACP >
Hark > SDK), ecosystem section, cleaner ASCII diagram with real example,
"What's next" roadmap teaser, Get Started nav link, footer links.

Quality improvements: Mermaid sequence diagrams in how-it-works (foreground,
async, discovery flows), common patterns section in add-oacp (background
query, foreground action, parameters), punchier index.mdx opening, ecosystem
voice commands in try-hark, richer apps.mdx with pattern explanations.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Change "Let any AI assistant control any Android app" to "Give your
Android app agentic powers. Open source." -- positive framing.

Change third-person "the creator's name" to first-person "my name" --
Hark is talking about his own project.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Set defaultTheme to "dark" and disable system preference detection
so all visitors see dark mode by default.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Fix "discovers and invoke" → "discovers and invokes" in hero subtext
- Fix footer link /docs/contributing → /docs/contributing/contributing
- Fix wake-word.mdx "the creator's name" → "my name"

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@0xharkirat 0xharkirat merged commit 1d4b26d into main Apr 11, 2026
0 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant