init

Expo Project Initialisation Wizard

Guide the user through setting up a new or existing Expo project with proper EAS configuration, environment-specific bundle IDs, and best practices.

Workflow Overview

1. Detect project state - New project or existing?
2. Gather app information - Name, bundle ID base, etc.
3. Configure EAS - Initialise and set up build profiles
4. Set up environments - Dev, preview, production bundle IDs
5. Configure push notifications - If needed
6. Customise project - README, CLAUDE.md updates
7. Summary and next steps

Project Detection

First, check the current project state:

# Check if in an Expo project
ls app.json app.config.js package.json 2>/dev/null | head -5

# Check if EAS is already configured
ls eas.json 2>/dev/null && echo "EAS configured" || echo "EAS not configured"

# Check for existing Expo installation
grep -q "expo" package.json 2>/dev/null && echo "Expo found" || echo "Expo not found"

Interactive Setup

Step 1: Project Status

AskUserQuestion({
  questions: [
    {
      question: "What's the current state of your project?",
      header: "Project",
      options: [
        {
          label: "New Expo project",
          description: "Just created with 'npx create-expo-app' or similar",
        },
        {
          label: "Existing Expo project",
          description: "Already have an Expo app, adding EAS",
        },
        {
          label: "Converting React Native project",
          description: "Existing RN app, adding Expo support",
        },
      ],
      multiSelect: false,
    },
  ],
});

Step 2: App Information

AskUserQuestion({
  questions: [
    {
      question: "What's your app name? (used for display)",
      header: "App Name",
      // Free text input via "Other"
      options: [
        {
          label: "Use existing name",
          description: "Keep the current app name from config",
        },
      ],
      multiSelect: false,
    },
    {
      question: "What's your bundle ID base? (e.g., com.yourcompany.yourapp)",
      header: "Bundle ID",
      options: [
        {
          label: "Use existing bundle ID",
          description: "Keep current bundle identifier",
        },
      ],
      multiSelect: false,
    },
    {
      question: "Will your app use push notifications?",
      header: "Push",
      options: [
        {
          label: "Yes",
          description: "Configure push notification credentials",
        },
        {
          label: "No",
          description: "Skip push notification setup",
        },
        {
          label: "Later",
          description: "I'll set this up later",
        },
      ],
      multiSelect: false,
    },
  ],
});