Skip to main content
Use this skill when someone asks you to set up Base44 white label, so their platform’s users can build apps under the platform’s brand. It takes you from credentials to a tested, working integration. You means the agent, and the person means whoever you’re setting this up for. Assume the person isn’t technical: explain each thing you ask them to do in one plain sentence, tell them exactly where to click, and never ask them to run a command. This file is the map. Each step below links to one page with the details. Read that page in full before you start the step.

Before you start: pick your path

Work out which path describes you, tell the person in one sentence which path you’re on, and follow that path wherever a step page shows a difference. On the Chat only path, don’t start the steps. Tell the person:
The integration always goes into the person’s platform, the product their users already sign in to. If they don’t have one yet and you’re on the App builder path, the app you’re editing becomes the platform. On the other paths, suggest they start one in an app builder such as Base44 and paste the message there. App builder path: two extra rules.
  • Every call to Base44’s white label API runs in a backend function, never in the app’s pages, so the token never reaches a browser.
  • Don’t hold one request open for a whole build. Start the build in one call and check its progress in later calls.

Working rules

  • The linked docs are the source of truth. Plan limits, permissions, field names, and settings live in the docs pages each step page links to. If this skill and a docs page disagree, follow the page and tell the person. If a page doesn’t load, tell the person which one and stop that step rather than guess.
  • Work through the steps in order. Each step depends on the one before it. Don’t skip ahead to writing code.
  • Do what you can yourself. Run commands, edit files, and check responses. Only ask the person for what needs their account, their decision, or their secret.
  • Verify before you continue. Every step ends with a check. If it fails, use the next action listed for that failure, or the troubleshooting page, not a guess.
  • Say when it’s not on them. When a check fails for a reason the person can’t fix, such as a platform limit or something you’ll handle yourself, say clearly that they don’t need to do anything.
  • Keep secrets out of the conversation. Never ask the person to paste a token or key into chat, and never print one in your output, logs, or commits. If they paste one anyway, tell them to delete it and create a new one, and don’t use the pasted one.
  • Stay on task. Don’t suggest unrelated changes to the person’s app while the setup is in progress.
  • Say what you deferred. When you leave something out to keep a build simple, or because the plan doesn’t include it, tell the person what it is and where it’s documented.

Steps

Copy this checklist into your notes and tick each step off as its check passes.
  • 1. Collect the keys. Get the workspace ID, save the personal access token as a secret, and confirm the token works. Read keys.
  • 2. Brand the agent. Turn on white label, and set the brand and agent names, the design system, and any skills. Read brand.
  • 3. Build the chat. Build the app-building chat into the platform, with sign-in, app ownership, embedding, and saved conversations. Read build the chat.
  • 4. Host it and set limits. Deploy or publish the integration, and queue builds so retries never charge twice. Read host and limits.
  • 5. Run the acceptance test. Test it the way the person’s customers will use it, and report what passed. Read acceptance test.
When any step fails and its page doesn’t cover the failure, read troubleshooting before you retry anything. Retrying a build call can create a duplicate app or charge credits twice. Don’t report the setup as complete until the acceptance test passes.
Keep integration credentials out of the customer experience. Don’t add access-key forms, access-file uploads, or private-link requirements for customers unless the person chose that access model. Tokens and keys belong in setup and server configuration only.