Skip to main content

spezi-platform-selection

Install this skill
npx skills add StanfordSpezi/SpeziVibe --skill spezi-platform-selection

Or install all skills: npx skills add StanfordSpezi/SpeziVibe --all. See the Getting Started guide for tool-specific options.

Runs after the other planning skills finish, when the user is ready to build with a Spezi template. Uses the planning briefs to recommend a platform, clones the matching Spezi starter template, and moves the existing docs/planning/ and docs/implementation-plan.md into the cloned repo so the coding agent has full context.

Skip this skill if you're not using a Spezi template — your planning briefs and implementation plan work just as well in any codebase. See Building Without a Spezi Template.

Platform Options​

  • React Native — cross-platform (iOS + Android) from one codebase. Good for forms, questionnaires, chat, and lightweight integrations. Backed by the Spezi React Native Template App.
  • Apple-native — Swift / SwiftUI for iPhone, iPad, and Vision Pro. Use when HealthKit, SensorKit, Bluetooth, or deep Apple integration is core to the product. Backed by the Spezi Template Application for Apple Platforms.

How It Works​

  1. Reads the planning briefs to understand requirements
  2. Recommends React Native or Apple-native with reasoning grounded in the briefs
  3. Checks your development machine setup (Xcode, Node.js, etc.)
  4. Clones the matching Spezi starter template to a location you specify
  5. Moves your planning briefs and implementation plan into the cloned repo

Output​

A cloned template repository with working navigation, theming, and project structure, plus your docs/planning/ and docs/implementation-plan.md already inside it. From here, your AI coding agent reads the plan and starts building.

Example​

AI:   What kind of app are you building? Does it primarily involve
      forms, questionnaires, and chat — or does it need HealthKit,
      SensorKit, Bluetooth, or deep Apple integration?

You:  It needs to read heart rate and step data from Apple Watch
      and connect to a Bluetooth blood pressure cuff

AI:   Those require HealthKit and CoreBluetooth, which work best
      natively on Apple platforms. I'd recommend going Apple-native.

      Let me check your setup — do you have Xcode installed?

You:  Yes, Xcode 16

AI:   Great. I'll clone the Spezi iOS template into your project
      directory and walk you through the structure.

Limitations​

  • Machine setup must complete before cloning
  • Switching platforms after cloning requires starting over