> ## Documentation Index
> Fetch the complete documentation index at: https://docs.patchline.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Sign up, claim your artist profile, tell Patchline what you're trying to get done, and land on the dashboard ready for Aria.

export const AriaPromptCard = ({prompt, surface = "web"}) => {
  const surfaces = {
    web: {
      href: "https://patchline.ai/dashboard",
      label: "Try in dashboard"
    },
    telegram: {
      href: "https://t.me/AriaMusicBizBot",
      label: "Try in Telegram"
    },
    claude: {
      href: "https://patchline.ai/claude",
      label: "Try in Claude"
    },
    mcp: {
      href: "https://patchline.ai/mcp",
      label: "Install MCP first"
    }
  };
  const s = surfaces[surface] ?? surfaces.web;
  return <div style={{
    display: "flex",
    justifyContent: "space-between",
    alignItems: "center",
    gap: "16px",
    padding: "12px 16px",
    marginBottom: "12px",
    borderRadius: "10px",
    border: "1px solid rgba(255,255,255,0.10)",
    background: "rgba(255,255,255,0.03)"
  }}>
      <code style={{
    fontFamily: "var(--font-family-mono)",
    fontSize: "14px",
    color: "inherit",
    flex: 1
  }}>
        "{prompt}"
      </code>
      <a href={s.href} target="_blank" rel="noopener noreferrer" style={{
    fontSize: "12px",
    fontWeight: 600,
    padding: "6px 12px",
    borderRadius: "999px",
    background: "linear-gradient(92deg, #00E6E2, #0068FF)",
    color: "#FFFFFF",
    textDecoration: "none",
    whiteSpace: "nowrap"
  }}>
        {s.label} →
      </a>
    </div>;
};

export const TierBadge = ({tier}) => {
  const styles = {
    free: {
      label: "Free",
      color: "#A1A1AA"
    },
    starter: {
      label: "Starter+",
      color: "#00E6E2"
    },
    pro: {
      label: "Pro+",
      color: "#0068FF"
    },
    scale: {
      label: "Scale+",
      color: "#7A5BFF"
    },
    enterprise: {
      label: "Enterprise",
      color: "#FF7A59"
    },
    all: {
      label: "All plans",
      color: "#22C55E"
    }
  };
  const t = styles[tier?.toLowerCase()] ?? styles.all;
  return <span style={{
    display: "inline-flex",
    alignItems: "center",
    gap: "4px",
    padding: "2px 10px",
    borderRadius: "999px",
    border: `1px solid ${t.color}40`,
    background: `${t.color}1A`,
    color: t.color,
    fontSize: "12px",
    fontWeight: 600,
    fontFamily: "var(--font-family-mono)",
    verticalAlign: "middle"
  }}>
      {t.label}
    </span>;
};

export const AICallout = ({page}) => {
  const slug = page ?? "";
  const mdUrl = `https://docs.patchline.ai${slug}.md`;
  return <div style={{
    marginTop: "32px",
    padding: "16px 20px",
    borderRadius: "12px",
    border: "1px solid rgba(0,230,226,0.25)",
    background: "linear-gradient(135deg, rgba(0,230,226,0.08), rgba(0,104,255,0.05))",
    color: "inherit",
    fontSize: "14px",
    lineHeight: 1.6
  }}>
      <strong style={{
    display: "block",
    marginBottom: "6px",
    color: "#00E6E2"
  }}>
        For AI agents reading this page
      </strong>
      The canonical machine-readable version of this page is at{" "}
      <a href={mdUrl}>
        <code>{mdUrl}</code>
      </a>
      . For product actions, connect to{" "}
      <code>www.patchline.ai/api/mcp/v1</code>
      {" "}and call MCP <code>tools/list</code> for the current tool schema.
      Rules for navigating these docs:{" "}
      <a href="https://docs.patchline.ai/AGENTS.md">
        <code>docs.patchline.ai/AGENTS.md</code>
      </a>
      .
    </div>;
};

By the end of this page Patchline knows who you are, what you're
trying to do, your catalog is loaded, and Aria is ready to act.

## Step 1 — Onboarding

<Steps>
  <Step title="Create your account">
    Go to [patchline.ai](https://patchline.ai). Sign up with Google or
    email.
  </Step>

  <Step title="Search for your artist name">
    Patchline asks for your artist name. Type it — we search across
    the real music landscape.
  </Step>

  <Step title="Claim your profile">
    Find yourself in the results and claim the profile. This wires
    your streaming presence, your audience, and your release history
    into your Patchline workspace.
  </Step>

  <Step title="Tell Patchline what you want">
    Patchline asks **what you're trying to get out of Patchline** —
    plan a release, run a roster, sell direct to fans, hand Aria to
    your team, whatever. Your answer steers Aria's defaults and the
    cards we show on your dashboard. Skip if you're just exploring.
  </Step>

  <Step title="Auto-import (if we have you)">
    If your artist is on streaming platforms and we already have data
    on you, **Patchline auto-imports 10 of your tracks** into your
    catalog as metadata rows. Upload audio for the tracks you want
    captioned, sold, or deeply analyzed.

    You can import more later from the Catalog tab.
  </Step>

  <Step title="Land on the dashboard">
    Onboarding done. You land on the Aria home screen.
  </Step>
</Steps>

## Step 2 — Get a track in (if you didn't auto-import)

Sidebar → **Catalog** → drag your file (MP3, WAV, FLAC) into the
upload zone. Aria starts captioning the moment the upload finishes.

<Note>
  **No tracks yet?** Skip this step. Aria still answers general
  music-business questions and helps you scope your first release.
</Note>

## Step 3 — While it processes, explore

Catalog processing runs in the background. Use the time:

* Open the **Profiles** tab — your claimed profile is there with the
  streaming, audience, and momentum context Patchline pulled.
* Hit the **Audience** tab — fan graph, growth signals, top markets.
* Glance at **Projects** — empty for now, but this is where your
  release plan will live.

The whole product is interconnected. The data Patchline pulled in
Step 1 already flows into every tab.

## Step 4 — Talk to Aria

Back to the dashboard. Aria is the home screen. Try:

<AriaPromptCard prompt="What do I do now, and why?" />

<AriaPromptCard prompt="What can you tell me about my catalog?" />

<AriaPromptCard prompt="Plan a release for my next track." />

<AriaPromptCard prompt="Where is my audience growing right now?" />

Aria reads your real data plus the music-business knowledge graph and
returns grounded answers with reasoning. If something's missing, Aria
says so and offers to fetch.

## That's the loop

The Patchline workflow, end-to-end:

1. **Bring your tracks** — import metadata, then upload audio for the
   tracks you want Patchline to analyze deeply.
2. **Start a project.**
3. **Get an optimized blueprint from Aria** — Aria pulls your data
   and the music-business knowledge graph and lays out the move.
4. **Generate assets** — cover art, promo flyers, videos.
5. **Set up your storefront and outbound links** — Music Store, smart
   links, drop links, pitch links.
6. **Use Aria and your AI stack to bring attention to those
   surfaces** — Aria, Claude, Cursor, Slack — anywhere your AI tools
   live.
7. **Capture fans straight into your Audience tab** — QR attribution,
   fan graph, growth signal.
8. **Sell your music with 0% fees on paid plans** — direct
   storefront, Stripe-powered payouts.
9. **Read fan behavior and feed it back into the next plan** — Audience
   feeds the next round of pitches and releases.
10. **Repeat.**

Everything is interconnected. Each step's output is the next step's
input — and Aria can move between them in one conversation.

## What to do next

<CardGroup cols={2}>
  <Card title="Plan a release" icon="rocket" href="/releases/release-planner">
    Aria builds the rollout from your catalog, audience, and release
    history.
  </Card>

  <Card title="Set up your storefront" icon="store" href="/storefront/overview">
    Sell direct to fans with **0% platform fees** on paid tiers.
  </Card>

  <Card title="Generate visuals" icon="palette" href="/visual-library/overview">
    Cover art, promo flyers, Canvas videos from your release context.
  </Card>

  <Card title="Install Aria in Claude / Cursor" icon="code" href="/for-agents/mcp-install">
    Connect Patchline's MCP server to your favorite AI tool.
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="My upload is still processing">
    Patchline queues every upload. Depending on volume across the
    platform, captioning can take a few minutes — it runs in the
    background, you don't need to sit on the catalog page. If it stays
    stuck for a long time, open the in-app **Support** button.
  </Accordion>

  <Accordion title="My streaming URL didn't import">
    Aria handles **Spotify** and **YouTube** URL types. Paste the
    canonical track URL into Aria and ask Aria to import.
  </Accordion>

  <Accordion title="Aria says 'I don't have access to that'">
    Aria is intentionally grounded. If you ask about a track that
    isn't in your catalog or an artist you haven't claimed, Aria says
    so and offers to fetch. That's the right behavior — better than
    inventing data.
  </Accordion>

  <Accordion title="I couldn't find my artist when searching">
    If your artist isn't in our index yet, you can still create a
    profile manually from the **Profiles** tab and upload your
    catalog directly.
  </Accordion>
</AccordionGroup>

<AICallout page="/get-started/quickstart" />