skills.rest
delta-and-beta
delta-and-betaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

architect-platform-setup

Configure Braze workspaces and onboard SDK integrations for new projects.

Updated Apr 6, 2026
Search Tags:#onboarding#integration#sdk#workspace#identity#pilot#braze
One-click install
npx skills add https://github.com/delta-and-beta/braze-agency --skill architect-platform-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architect-platform-setup
Source: https://github.com/delta-and-beta/braze-agency/tree/main/skills/architect-platform-setup
Command: npx skills add https://github.com/delta-and-beta/braze-agency --skill architect-platform-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

Frequently Asked Questions about architect-platform-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Braze workspaces and SDK onboarding for a new project?▼

Workspace topology design for Braze onboarding determines whether to separate dev and prod workspaces or consolidate apps. Separating workspaces prevents environment misconfigurations and identity fragmentation, while consolidation simplifies management for smaller projects.

How do I configure Braze SDK integration and external_id transitions correctly?▼

Configure Braze SDK integration by initializing with the correct workspace API key and calling changeUser() to set the external_id upon user login. This timing prevents identity fragmentation and ensures user event data merges correctly in the dashboard.

What is Braze Pilot sandbox and how do I use it for campaign testing?▼

Braze Pilot sandbox is a testing environment to validate campaigns before production. You connect to Pilot, utilize deep links for navigation, and reference the Pilot data dictionary to verify event payloads and campaign behavior safely.

What privacy compliance and administrative settings do I need for Braze platform onboarding?▼

Braze platform onboarding requires configuring dashboard roles, push credentials, email domains, and data retention policies. You must also complete privacy portal actions for GDPR and CCPA workflows to ensure compliance before launching campaigns.

Why are my Braze API keys mis-scoped and how do I fix environment separation?▼

Mis-scoped Braze API keys occur when dev and prod environments share workspace configurations. Fix environment separation by creating distinct workspaces, generating workspace-specific API keys, and verifying app instances per platform to isolate data flows.

Related Skills

Explore More Software Engineering Skills→
delta-and-betadelta-and-beta

strategist-banners

Define Braze Banner strategy with cross-platform guidance for Web, iOS, and Android.

Community
Advanced
delta-and-betadelta-and-beta

strategist-campaign-management

Plan Braze campaign launches and optimize Canvas journeys using send analytics.

Community
Intermediate
rcmaplesrcmaples

fullstory-privacy-strategy

Guide privacy-conscious Fullstory data handling with GDPR, HIPAA, PCI, and CCPA alignment.

Community
Advanced
TMHSDigitalTMHSDigital
2

mobile-maps-location

Add maps and geolocation to Expo React Native and Flutter apps.

Community
Intermediate