architect-platform-setup

What problem does it solve?

Provide a repeatable, system-level process for configuring Braze workspaces, preparing SDK integrations, and validating initial platform readiness to avoid identity fragmentation, mis-scoped API keys, and environment misconfigurations.

Core Features & Use Cases

• Workspace Topology Guidance: Recommend when to separate workspaces vs. consolidate apps, and list workspace-scoped elements to plan (apps, API keys, connectors).
• SDK Integration Checklist: Verify SDK initialization, correct API key usage, changeUser() timing for external_id, push permission flow, and basic QA steps to confirm data arrival.
• Braze Pilot & Testing: Explain how to connect and use Braze Pilot, deep links, and the Pilot data dictionary to validate campaigns before production.
• Administrative & Privacy Configuration: Surface required dashboard settings (roles, push credentials, email domains), data retention, and privacy portal actions for GDPR/CCPA workflows.
• Operational Playbook: Actionable onboarding FAQ, validation steps, and references to detailed topic files for deep dives.

Quick Start

Configure a new Braze workspace for project "my-app" with separate dev and prod workspaces, create app instances per platform, initialize the SDK with the correct workspace API key, call changeUser() on login, and verify events in User Search.