Crossdeck Docs
Dashboard

Errors USP · AI-assisted

Setting up source maps with an AI assistant

If you use Cursor, Claude Code, Codex, GitHub Copilot, or any AI coding assistant, you can set up Crossdeck source-map uploads in one paste. The prompt is personalised for your project's framework + deploy target, so the assistant has everything it needs to do the setup in one pass.

The prompt is generated server-side at click-time from your project's recent events (detected framework, deploy target, key prefix). Two different projects get two different prompts.

How it works

  1. Open your project in your AI assistant.
  2. Click Copy AI prompt above.
  3. Paste it into your AI assistant.
  4. The assistant installs @cross-deck/cli, configures your bundler, adds the CI step, wires the release identifier into your SDK init, and tells you what it changed.
  5. Review the diff, commit, deploy. Trigger a test error — the dashboard shows readable file paths within seconds.
Heads-up: the prompt includes your project's publishable key prefix so the assistant knows which Crossdeck project it's setting up. It tells the assistant to add your secret key (cd_sk_live_…) to your CI secrets — never to commit it to git. Grab the secret key from Developers → API keys.

What the prompt covers

The assistant will:

  • Install @cross-deck/cli as a dev dependency using your project's package manager.
  • Configure your bundler to emit external source maps with sourcesContent inlined (Vite, Webpack, Next.js, Rollup, ESBuild — whichever you use).
  • Add the source-map upload step to your CI pipeline (GitHub Actions, GitLab CI, Vercel, Netlify, etc.).
  • Stamp the git SHA as the appVersion in your Crossdeck.init() call so uploads pair with events.
  • Strip .map files from the deploy artefact so they don't get served publicly.
  • Tell you exactly which CI secret to add and where (CROSSDECK_AUTH_TOKEN).

Which AI assistants does this work with?

Any of them. The prompt is plain text and self-contained — no tool-use, no provider-specific syntax:

  • Cursor — paste into chat, the diff appears in your editor.
  • Claude Code — paste into the terminal interface.
  • GitHub Copilot Chat — paste into the chat side panel.
  • Codex — paste into the terminal interface or the cloud agent.
  • Aider / Continue / any open-source assistant — same paste, same outcome.
  • Or any chat AI (ChatGPT, Claude.ai, Gemini) for guidance you apply manually.

Prefer to do this by hand?

The manual setup guide covers everything in framework-by-framework recipes — Vite, Webpack, Next.js, Rollup, ESBuild — with CI examples for GitHub Actions, GitLab CI, Vercel, and Netlify. Same outcome, more typing.

CLI source is public at github.com/VistaApps-za/crossdeck-cli. File an issue there, or email support@cross-deck.com.