QA Fixes improving overall docs + mini app docs (#300)

* Make Ask AI Button primary CTA in header

* Downgrade base.org button to standard link

* Update submit to ecosystem to point to GH instructions

* Update links doc to include viewcast and minikit instructions

* fix typos

Author: ericbrown99

docs/custom.css

@@ -10,6 +10,33 @@
   background-color: rgba(239, 68, 68, 0.1);
 }
 
+.assistant-entry {
+  background-color: #3c8aff;
+  color: #ffffff;
+  border: 1px solid rgba(0, 0, 0, 0.15);
+  box-shadow: none;
+  font-weight: 600;
+}
+
+.assistant-entry:hover {
+  transform: translateY(-1px);
+  box-shadow: none;
+}
+
+.assistant-entry:focus-visible {
+  outline: 2px solid rgba(0, 0, 0, 0.25);
+  outline-offset: 2px;
+}
+
+.dark .assistant-entry {
+  background-color: #3c8aff;
+  border-color: rgba(0, 0, 0, 0.55);
+}
+
+.dark .assistant-entry:focus-visible {
+  outline: 2px solid rgba(0, 0, 0, 0.65);
+}
+
 .base_header_img {
   margin: auto;
 }

docs/docs.json

@@ -499,7 +499,7 @@
           {
             "group": "Resources",
             "pages": [
-              "mini-apps/resources/resources",
+              "mini-apps/resources/templates",
               "mini-apps/llms-full.txt"
             ]
           }
@@ -1247,13 +1247,12 @@
       {
         "label": "Support",
         "href": "https://discord.com/invite/buildonbase"
+      },
+      {
+        "label": "Base.org",
+        "href": "https://base.org"
       }
-    ],
-    "primary": {
-      "type": "button",
-      "label": "Base.org",
-      "href": "https://base.org"
-    }
+    ]
   },
   "footer": {
     "socials": {

docs/get-started/base.mdx

@@ -89,7 +89,7 @@ Explore [all products](/get-started/products) and [use cases](/get-started/use-c
   <Card
     title="Submit to Base Ecosystem Page"
     icon="globe"
-    href="https://www.base.org/ecosystem"
+    href="https://github.com/base/web?tab=readme-ov-file#updating-the-base-ecosystem-page"
   >
     Showcase your project to the Base community and get discovered.
   </Card>

docs/mini-apps/features/links.mdx

@@ -18,39 +18,141 @@ Avoid using direct HTML links (`<a href="">`, `<Link href="">`) or static URLs i
 ## External Navigation
 
 ### Opening External URLs
+<Tabs>
+  <Tab title="With MiniKit">
+
+  Use [`useOpenUrl()`](/mini-apps/technical-reference/minikit/hooks/useOpenUrl) to safely open external websites in the client's in-app browser:
+  ```tsx components/ExternalLinks.tsx
+  import { useOpenUrl } from '@coinbase/onchainkit/minikit';
+
+  export default function ExternalLinks() {
+    const openUrl = useOpenUrl();
+
+    return (
+      <div className="external-links">
+        <button onClick={() => openUrl('https://base.org')}>
+          Visit Base.org
+        </button>
+        <button onClick={() => openUrl('https://twitter.com/base')}>
+          Follow on Twitter
+        </button>
+        <button onClick={() => openUrl('https://discord.gg/basechain')}>
+          Join Discord
+        </button>
+      </div>
+    );
+  }
 
-Use `sdk.actions.openUrl()` to safely open external websites in the client's in-app browser:
+  // Incorrect: Direct HTML link
+  // <a href="https://example.com">Visit Site</a>
+  ```
+  </Tab>
 
-```typescript App.tsx
-import { sdk } from '@@farcaster/miniapp-sdk';
+  <Tab title="Without MiniKit">
 
-// Correct: Use SDK action
-const openExternalSite = () => {
-  sdk.actions.openUrl('https://example.com');
-};
+  Use `sdk.actions.openUrl()` to safely open external websites in the client's in-app browser:
 
-// Incorrect: Direct HTML link
-// <a href="https://example.com">Visit Site</a>
-```
+  ```typescript App.tsx
+  import { sdk } from '@farcaster/miniapp-sdk';
+
+  // Correct: Use SDK action
+  const openExternalSite = () => {
+    sdk.actions.openUrl('https://example.com');
+  };
+
+  // Incorrect: Direct HTML link
+  // <a href="https://example.com">Visit Site</a>
+  ```
+  </Tab>
+</Tabs>
 
 ### Composing Casts
 
-Use `sdk.actions.composeCast()` instead of composer intent URLs:
+<Tabs>
+  <Tab title="With MiniKit">
+
+  Use [`useComposeCast()`](/mini-apps/technical-reference/minikit/hooks/useComposeCast) to open the native composer with prefilled content:
+  ```tsx components/ShareCast.tsx
+  import { useComposeCast } from '@coinbase/onchainkit/minikit';
+
+  export default function ShareCast() {
+    const { composeCast } = useComposeCast();
+
+    return (
+      <button
+        onClick={() =>
+          composeCast({
+            text: 'Check out this Mini App!',
+            embeds: [window.location.href]
+          })
+        }
+      >
+        Share This App
+      </button>
+    );
+  }
+
+  // Incorrect: Composer intent URLs
+  // window.open('https://farcaster.com/~/compose?text=...')
+  ```
+  </Tab>
 
-```typescript App.tsx
-import { sdk } from '@farcaster/miniapp-sdk';
+  <Tab title="Without MiniKit">
 
-// Correct: Use SDK action
-const shareContent = () => {
-  sdk.actions.composeCast({
-    text: 'Check out this Mini App!',
-    embeds: ['https://yourminiapp.com']
-  });
-};
+  Use `sdk.actions.composeCast()` instead of composer intent URLs:
 
-// Incorrect: Composer intent URLs
-// window.open('https://farcaster.com/~/compose?text=...')
-```
+  ```typescript App.tsx
+  import { sdk } from '@farcaster/miniapp-sdk';
+
+  // Correct: Use SDK action
+  const shareContent = () => {
+    sdk.actions.composeCast({
+      text: 'Check out this Mini App!',
+      embeds: ['https://yourminiapp.com']
+    });
+  };
+
+  // Incorrect: Composer intent URLs
+  // window.open('https://farcaster.com/~/compose?text=...')
+  ```
+  </Tab>
+</Tabs>
+
+### Viewing Casts 
+
+<Tabs>
+  <Tab title="With MiniKit">
+
+  Use [`useViewCast()`](/mini-apps/technical-reference/minikit/hooks/useViewCast) to open a specific cast by its hash:
+  ```tsx components/ViewCastButton.tsx
+  import { useViewCast } from '@coinbase/onchainkit/minikit';
+
+  export default function ViewCastButton() {
+    const viewCast = useViewCast('0x1234567890abcdef1234567890abcdef12345678');
+
+    return (
+      <button onClick={viewCast}>
+        View Cast
+      </button>
+    );
+  }
+  ```
+  </Tab>
+
+  <Tab title="Without MiniKit">
+
+  Use `sdk.actions.viewCast()` instead of cast intent URLs:
+
+  ```typescript App.tsx
+  import { sdk } from '@farcaster/miniapp-sdk';
+
+  // Correct: Use SDK action
+  const viewCast = () => {
+    sdk.actions.viewCast('https://farcaster.com/cast/1234567890');
+  };
+  ```
+  </Tab>
+</Tabs>
 
 ## Best Practices
 
@@ -67,7 +169,7 @@ Before implementing any navigation or linking functionality:
 When using features that may not be supported in all clients:
 
 ```javascript App.tsx
-import { sdk } from '@@farcaster/miniapp-sdk';
+import { sdk } from '@farcaster/miniapp-sdk';
 
 const handleExternalLink = (url) => {
   try {
@@ -88,7 +190,7 @@ Don't hardcode URLs specific to particular clients (like Warpcast URLs). Instead
 ### Navigation Buttons
 
 ```javascript NavigationComponent.tsx
-import { sdk } from '@@farcaster/miniapp-sdk';
+import { sdk } from 'farcaster/miniapp-sdk';
 
 const NavigationComponent = () => {
   const handleExternalLink = () => {
@@ -118,7 +220,7 @@ const NavigationComponent = () => {
 ### Conditional Navigation
 
 ```javascript ConditionalNavigation.tsx
-import { sdk } from '@@farcaster/miniapp-sdk';
+import { sdk } from 'farcaster/miniapp-sdk';
 
 const ConditionalNavigation = () => {
   const context = sdk.context;

docs/mini-apps/resources/resources.mdx docs/mini-apps/resources/templates.mdxdocs/mini-apps/resources/resources.mdx renamed to docs/mini-apps/resources/templates.mdx

@@ -71,7 +71,7 @@ Production-ready code repositories that you can clone and deploy immediately.
  <Card 
     title="Full Mini Demo" 
     icon="github" 
-    href="https://github.com/base/demos/tree/master/minikit/full-mini-demo"
+    href="https://github.com/base/demos/tree/master/minikit/mini-app-full-demo"
   >
     A comprehensive showcase demonstrating the complete range of MiniKit capabilities and Base ecosystem integrations.
   </Card>