Update quickstart.mdx

Author: mintlify-development[bot]

quickstart.mdx

@@ -4,126 +4,155 @@ description: "Get your documentation site live in under 10 minutes"
 icon: "rocket"
 ---
 
-Create beautiful documentation in minutes. This guide gets you from zero to a live documentation site with automatic deployments.
+Transform your documentation from idea to live site in minutes. No complex setup, no waiting around.
 
-## Step 1: Create your account
-
-Sign up at [mintlify.com/start](https://mintlify.com/start). Your first documentation site is created automatically during onboarding.
+<CardGroup cols={2}>
+  <Card title="🚀 Launch in 5 minutes" icon="clock">
+    Get a live site with zero configuration
+  </Card>
+  <Card title="✨ Edit anywhere" icon="edit">
+    Browser editor or local development
+  </Card>
+</CardGroup>
 
-Your site goes live immediately at `https://<your-project-name>.mintlify.app`.
+## Get started now
 
-## Step 2: Connect GitHub
+### 1. Create your site
 
-Enable automatic deployments by connecting your GitHub repository.
+Visit [mintlify.com/start](https://mintlify.com/start) and sign up. Your documentation site is created instantly and goes live at:
 
-<Steps>
-  <Step title="Install GitHub App">
-    Go to **Settings** → **GitHub App** and click **Install GitHub App**. Select your organization and repositories.
-  </Step>
-  <Step title="Authorize account">
-    Navigate to **Settings** → **My Profile** and click **Authorize GitHub account**.
-  </Step>
-</Steps>
+```
+https://your-project-name.mintlify.app
+```
 
-## Step 3: Start editing
+That's it. You now have a live documentation site.
 
-Choose how you want to work with your documentation:
+### 2. Make it yours
 
 <Tabs>
-  <Tab title="Web Editor">
-    Edit directly in your browser - no setup required.
+  <Tab title="Quick edits">
+    **Edit in your browser** - no downloads needed
 
     1. Open your [dashboard](https://dashboard.mintlify.com)
-    2. Click **Editor** in the sidebar
-    3. Select any file to start editing
-    4. Click **Publish** to deploy changes instantly
+    2. Click **Editor** 
+    3. Edit any page
+    4. Hit **Publish**
 
-    <Frame>
-      <img alt="Web editor" src="/images/quickstart/web-editor-light.png" className="block dark:hidden" />
-      <img alt="Web editor" src="/images/quickstart/web-editor-dark.png" className="hidden dark:block" />
-    </Frame>
+    Changes go live instantly.
   </Tab>
 
-  <Tab title="Local Development">
-    Work locally with your favorite tools and Git workflow.
+  <Tab title="Full control">
+    **Work locally** with your preferred tools
 
-    **Install CLI:**
     ```bash
     npm i -g mint
+    mint dev
     ```
 
-    **Edit and preview:**
-    1. Edit any `.mdx` file in your repository
-    2. Run `mint dev` to preview at `localhost:3000`
-    3. Push changes to GitHub for automatic deployment
-    
-    <Warning>
-    Requires Node.js v19+. Check with `node --version`.
-    </Warning>
+    Edit `.mdx` files, preview at `localhost:3000`, push to deploy.
   </Tab>
 </Tabs>
 
-## Step 4: Customize your site
+### 3. Connect GitHub (optional)
 
-Make it yours with these quick customizations:
+Enable automatic deployments:
 
-<CardGroup cols={3}>
-  <Card title="Brand colors" icon="palette">
-    Update `docs.json` with your brand colors and logo
-  </Card>
-  <Card title="Navigation" icon="bars">
-    Organize pages into groups and sections
+1. **Settings** → **GitHub App** → **Install GitHub App**
+2. **Settings** → **My Profile** → **Authorize GitHub account**
+
+Now every push to your repo updates your site automatically.
+
+## Essential customizations
+
+<CardGroup cols={2}>
+  <Card title="Brand it" icon="paintbrush">
+    **Update `docs.json`**
+    
+    ```json
+    {
+      "name": "Your Docs",
+      "logo": "/logo.png",
+      "colors": {
+        "primary": "#0D9373"
+      }
+    }
+    ```
   </Card>
-  <Card title="Custom domain" icon="globe">
-    Replace `.mintlify.app` with your own domain
+  
+  <Card title="Organize content" icon="folder">
+    **Structure your navigation**
+    
+    ```json
+    {
+      "navigation": [
+        {
+          "group": "Getting Started",
+          "pages": ["quickstart", "setup"]
+        }
+      ]
+    }
+    ```
   </Card>
 </CardGroup>
 
-### Add a custom domain
+### Add your domain
+
+Replace `.mintlify.app` with your own domain:
 
-1. Go to **Settings** → **Custom Domain**
-2. Enter your domain (e.g., `docs.company.com`)
-3. Add this CNAME record to your DNS:
+1. **Settings** → **Custom Domain**
+2. Enter your domain: `docs.yoursite.com`
+3. Add CNAME record:
 
-| Type | Name | Value | TTL |
-|------|------|-------|-----|
-| CNAME | docs | cname.mintlify.app | 3600 |
+```
+CNAME docs cname.mintlify.app
+```
 
 <Info>
-DNS changes take 5-30 minutes to propagate.
+DNS changes take 5-30 minutes. Use [DNSChecker](https://dnschecker.org) to verify.
 </Info>
 
-## What's next?
+## What you can build
 
-<CardGroup cols={2}>
-  <Card title="Write content" icon="pen" href="/writing-content/page">
-    Learn MDX syntax and use interactive components
+<CardGroup cols={3}>
+  <Card title="Rich content" icon="file-text" href="/writing-content/page">
+    MDX, components, interactive elements
   </Card>
   <Card title="API docs" icon="code" href="/api-playground/overview">
-    Generate interactive API documentation
-  </Card>
-  <Card title="Themes" icon="paintbrush" href="/themes">
-    Customize colors, fonts, and styling
+    Auto-generated from OpenAPI specs
   </Card>
-  <Card title="Analytics" icon="chart-line" href="/analytics/overview">
-    Track usage and optimize your documentation
+  <Card title="Custom themes" icon="palette" href="/themes">
+    Colors, fonts, layouts
   </Card>
 </CardGroup>
 
-## Troubleshooting
+## Common issues
 
 <AccordionGroup>
-  <Accordion title="Site not updating after pushing changes">
-    Check GitHub Actions for build errors. Builds typically take 1-3 minutes.
+  <Accordion title="Changes not showing up?">
+    **GitHub users:** Check Actions tab for build status (takes 1-3 minutes)
+    
+    **Web editor:** Changes are instant - try refreshing your site
   </Accordion>
 
-  <Accordion title="Local preview not working">
-    Ensure Node.js v19+ is installed and run `mint dev` from your project root (where `docs.json` exists).
+  <Accordion title="mint dev not working?">
+    Make sure you're in the right directory (where `docs.json` lives) and using Node.js v19+:
+    
+    ```bash
+    node --version  # Should be v19+
+    cd path/to/your/docs
+    mint dev
+    ```
   </Accordion>
 
-  <Accordion title="Custom domain not connecting">
-    Verify your CNAME record and wait for DNS propagation. Use [DNSChecker](https://dnschecker.org) to verify.
+  <Accordion title="Domain not connecting?">
+    1. Double-check your CNAME record
+    2. Wait for DNS propagation (up to 30 minutes)
+    3. Verify with [DNSChecker](https://dnschecker.org)
   </Accordion>
 </AccordionGroup>
 
-Need more help? [Contact support](contact-support) or check our [community forum](https://community.mintlify.com).
+---
+
+**Need help?** [Contact support](contact-support) or join our [community](https://community.mintlify.com).
+
+**Ready for more?** Explore [advanced features](/writing-content/page) and [integrations](/integrations/overview).