Fictura
Dashboard

Setup

Six steps, each one a prompt you paste into your coding agent, and each one ticks itself when real data arrives. Keys, money settings and imports live under More settings.

Dashboard → Setup, at the bottom of the sidebar above Tools and Help. An app whose free trial has not started lands here. The account menu item Get apps and SDKs opens it too.

Setup takes the selected app through six steps, in order. You paste one prompt per step into your coding agent, and the agent does the work using Fictura's docs and MCP server. Everything else this page holds, like your keys, sits under More settings.

Setup and Tools both stay open before an app is activated. Every other tab opens once the free trial starts.

The six steps

One step is open at a time. Each tick comes from real data, so a step you finished shows as finished and a step that never really worked stays open. The page rechecks every few seconds while it's on screen, ticks the step and opens the next one.

#StepWhat you doIt ticks when
1Install the SDKCopy the prompt and paste it. It carries your real key.Your app's first event arrives.
2Connect your coding agentPick your agent, run the command or press install, and sign in. Choose Read and edit.The agent has connected.
3Set up event analyticsCopy the prompt and paste it.Your first event that isn't automatic arrives.
4Set up attribution and deep linksCopy the prompt, paste it, then tap one test link on a phone.Your bundle ID and Team ID are saved and a link exists. A second tick shows when a real tap reaches your app.
5Set up errors and crashesCopy the prompt, paste it, then create one upload key.Your first error arrives. Source maps get their own optional tick.
6Set up performanceCopy the prompt and paste it.Your first trace arrives. It may tick by itself, because the SDK traces by default.

Steps 3 to 6 say Connect your agent first until step 2 is done, because their prompts use it. You can still open them.

These work in Claude Code, Cursor, VS Code and Codex, the agents that can edit your code. The SDK is for Expo and React Native apps, and on anything else the prompt stops and says so.

The prompts stay short because the instructions live on the server. An agent calls the MCP tool get_setup_step, which returns the steps, your real values and the right docs pages, so a prompt you copied last week still gets today's instructions.

When all six are done, the steps fold to one line and your settings become the main view. Things you can add when you need them are folded under Optional, below the steps.

Your free trial

Connecting your agent in step 2 starts your free trial, once per app. It lasts 30 days, with no card. Until then, every tab but Setup and Tools says to connect your agent and links to it.

  • Open during the trial: the dashboard and every MCP tool, with no limit on MCP calls or events.
  • The one limit: Hawkings and the other AI features use a monthly allowance. See AI.
  • A banner at the top of each page shows the days left, with a link to Activate.
  • When it ends: the dashboard and MCP lock until you activate. Your app keeps sending, so no data is lost.

More settings

The row under the steps opens one section at a time. Each has its own address, like /dashboard/setup?section=keys, so you can bookmark it or send it to a teammate.

Keys & webhook

The two values that connect your app to Fictura. Both are always here to copy.

ValueWhere it goes
RevenueCat webhookIn RevenueCat, Project → Integrations → Webhooks. Billing events flow in as soon as you save it there. See RevenueCat webhooks.
SDK app keyPassed to the SDK when it starts. See SDK keys & config refresh.

Press Copy next to either one.

Below them, Data API keys are keys for your own servers. Tick the scopes the key needs (events:read to read raw events and people, users:delete to delete a person), name it, and press Create key. The key is shown once; copy it then. The trash icon revokes a key. See Authentication.

SDK & errors

The code that starts the SDK. One start call turns on events, crashes and error reports. Your key is already filled in.

Install with Claude Code is one prompt for Claude Code, Cursor or any coding agent open on your app. It installs the SDK and wires it up with this app's key. Press Copy prompt and paste it there.

To do it by hand, pick React Native, Python or Node, then press Copy. See How error tracking works.

Key events

The three events that say a user got started (Activation), paid (Conversion) and got real value (Value moment). Each shows its events and users in the last 30 days and a health badge. Pick an event from the list beside a role to set it. These are the same pickers as Events → Manage → Key events; a change in one shows in the other. See Key events.

Revenue

What the stores keep before you are paid. Net revenue and every ROAS on Attribution use these settings.

  • Store commission. Pick 15%, small business, 30%, standard, or Custom. Custom shows a Commission rate box.
  • Sales tax or VAT (optional). Leave it at 0 unless you know your rate. When RevenueCat sends its own tax for a sale, that is used instead.
  • List prices include tax. Turn it on if your store prices already include tax.

Press Save. The new rates apply to sales from now on. Revenue you already have keeps the rate it came in with, so past reports do not change.

AI

Your own Anthropic key. Hawkings and the paywall, onboarding and ad copy generators run on it. Anthropic bills you for it directly.

Nothing AI works until you add a key, unless your app's plan includes AI. If it does, a key you add is used first, and it keeps AI running once the plan's monthly allowance is spent.

  1. Make a key at console.anthropic.com/settings/keys.
  2. Paste it and press Save key. It is checked with Anthropic before it is saved.

Once saved, the section says AI features are on, with the start and end of your key. From there you can:

  • Replace it with a new key.
  • Remove it. This turns off Hawkings and every generator. Fictura never cancels anything at Anthropic.

If Anthropic later turns the key down, the section says Anthropic rejected this key and the list shows rejected. Most often the key was revoked, changed, or the account ran out of credit. Paste a working key to fix it.

Coding agents

Connect an AI client — Claude, ChatGPT, Claude Code, Codex, Cursor or VS Code — to this app's live data while it writes your code. It reads by default. It writes only what you allow, like draft paywalls and tracking links, and never a live paywall.

There are two ways to connect. Pick one under Connect with:

  • Sign in with Fictura. Nothing to create here. Pick your tool and copy the snippet, or press Add to Cursor or Install in VS Code. The first time the agent needs your data, the tool asks you to sign in, pick this app and choose read only or read and edit.
  • MCP key. For CI, scripts, shared configs and the OpenAI API.
    1. Give the key a name if you want. Tick Can edit to let the agent change draft paywalls and onboarding flows, save this app's identity and create tracking links, or Can connect and import data to let it import from AppsFlyer. Neither can be added later. Press Create key.
    2. Copy the key right away. It is shown once and cannot be shown again. A lost key is replaced, not recovered.
    3. Pick your tool and press Copy snippet. The snippet has your new key in it, and Add to Cursor installs it in one click.

Each key in the list shows when it was last used. Revoke stops it at once and cannot be undone. Tools you signed in from show under Signed-in connections, where Disconnect removes them. See MCP server for every client and every tool.

Web checkout

Send iPhone users to your own Stripe checkout instead of Apple's payment sheet. If Web checkout is missing from the list, it is not available for your app yet.

  • On / Off at the top turns it on or off. It stays off until Stripe is connected and you have picked a plan or added a link.
  • Checkout page. Fictura hosts it, or I have my own.
  • What are you selling? Your Stripe plan, when Fictura hosts the page. Connect Stripe in Tools first.
  • Free trial (days). Leave blank for none.
  • Purchase link. Your own checkout page, when you have your own.
  • Countries. Two-letter codes, with commas between them. A device whose country cannot be read gets Apple's sheet.
  • Return deep link. Where buyers go back to in your app when they are done.

Press Save. Devices pick up the change on their next config refresh.

Below the form you see whether purchases report back to Fictura, the Checkout URL to test, and Fee avoided so far, counted from real payments. See How web checkout works.

You handle the tax

With web checkout on, you are the seller. Sales tax on those payments is yours to handle, not Apple's. Turning it off puts everyone back on Apple's sheet within one config refresh.

Import data

Your webhook only reports what happens from now on. Import data brings in everything from before. It only shows when there is a source to import from.

Pick the tool you are moving from.

RevenueCat or AppsFlyer. Each card says if it is already imported, importing now, or connected but not imported yet. Appfigures and PostHog are listed but not available yet.

Connect it.

For RevenueCat, paste the key the card asks for. AppsFlyer connects in Tools, and the card points you there.

Bring your history in.

Press Start the import. It keeps running if you close the tab. You can also upload the tool's export file as a CSV. It is safe to do both. Anything that arrives twice is counted once.

Watch it fill.

A progress card shows the import as it runs. When it is done, See it on the dashboard opens Overview. Import something else goes back to the list.

If a source is already imported, Check for anything new only pulls what has landed since the last run. RevenueCat has no such button, because its list cannot be asked for only what is new. Import everything again is a separate button that asks you to confirm. See Migrate in and Leave AppsFlyer.

Connecting other accounts

Slack, Stripe, Google and the other third-party accounts are not connected in Setup. They connect from Tools, and an old ?section=connections link opens Tools. Flip the switch on a tile under Third-party tools to set it up there, or press Manage on one you already connected.

Each one is checked with the provider before it is saved. Keys are stored encrypted and never shown again.

TileGuide
RevenueCatShows your webhook address to paste. RevenueCat webhooks
Paid AcquisitionAdds Paid Ads to the sidebar.
Slack AlertsSlack
Email AlertsResend
PostHog ExportPostHog
StripeStripe
Outgoing WebhooksWebhooks
App Store ConnectApp Store Connect
PostizAdds Posts to the sidebar.
Google Search ConsoleAdds Search to the sidebar. Guide: Google Search Console.
Google Cloud CostsAdds Cloud Costs to the sidebar. Guide: Google Cloud Costs.
AppfiguresStore downloads, revenue, ratings and reviews, for Hawkings and your coding agents to read.

With an outgoing webhook connected, its Manage window shows recent deliveries and their retries. A paused endpoint shows a Resume button. See Retries and pausing.

On this page