Documentation

the_flutter_kit/
├── lib/
│   ├── config/              # AppConfig, Secrets, FeatureFlags
│   ├── core/
│   │   ├── di/              # Dependency injection (get_it)
│   │   ├── router/          # GoRouter with typed routes
│   │   ├── theme/           # Material 3 design tokens
│   │   ├── services/        # PurchasesService, AIService
│   │   ├── analytics/       # AnalyticsService (GA4)
│   │   ├── notifications/   # PushMessagingService, local
│   │   └── utils/           # Extensions, helpers
│   ├── features/
│   │   ├── onboarding/      # 3 onboarding templates
│   │   ├── auth/            # Firebase Auth flows
│   │   ├── profile/         # Profile setup, avatar upload
│   │   ├── paywall/         # RevenueCat paywall UI
│   │   ├── home/            # Home screen
│   │   ├── settings/        # Settings & preferences
│   │   └── ai/              # Chat, image, vision screens
│   └── widgets/             # Reusable UI components
├── backend/
│   └── flask/               # AI proxy server
├── assets/                  # Images, fonts
└── test/                    # Unit & widget tests

class AppConfig {
  static const appName = 'MyApp';
  static const backend = Backend.firebase;
  static const onboardingStyle = OnboardingStyle.carousel;

  static const featureFlags = FeatureFlags(
    onboarding: true,
    authentication: true,
    paywall: true,
    notifications: true,
    aiFeatures: false,
  );

  static const legal = LegalConfig(
    privacyURL: 'https://yourapp.com/privacy',
    termsURL: 'https://yourapp.com/terms',
  );
}

class Secrets {
  static const firebaseProjectId = 'your-project-id';
  static const revenueCatPublicKey = 'appl_...';
  static const openAIKey = 'sk-...';
  static const analyticsKey = '';
}

// Sign up and sign in are one-liners:
final credential = await FirebaseAuth.instance
    .createUserWithEmailAndPassword(
  email: email,
  password: password,
);

// Session is persisted automatically.
// Profile setup screen appears after first sign-in.

// Auth flow is automatic:
// 1. Onboarding (if enabled & not completed)
// 2. Sign In (if enabled & not authenticated)
// 3. Profile Setup (if profile is incomplete)
// 4. Main App

// Change this one line to switch onboarding:
static const onboardingStyle = OnboardingStyle.highlights;
// Options: .carousel, .highlights, .minimal

static final defaultPages = [
  OnboardingPage(
    title: 'Welcome to {{appName}}',
    subtitle: 'Your personal AI assistant',
    icon: Icons.auto_awesome,
  ),
  OnboardingPage(
    title: 'Smart & Private',
    subtitle: 'Your data stays on your device',
    icon: Icons.lock_outline,
  ),
  OnboardingPage(
    title: 'Ready to Go',
    subtitle: 'Set up in seconds',
    icon: Icons.rocket_launch,
  ),
];

// The paywall shows automatically when no active entitlement
// is detected. Customize the UI here — the business logic
// is handled by PurchasesService.

class PaywallPage extends StatelessWidget {
  const PaywallPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Column(
        children: [
          // Hero section
          // Package options (monthly, yearly)
          // Purchase button
          // Restore purchases link
        ],
      ),
    );
  }
}

# Install dependencies
cd backend/flask
pip install -r requirements.txt

# Set your OpenAI key
export OPENAI_API_KEY="sk-..."

# Start the server
python main.py

# Verify it's running
curl http://127.0.0.1:5001/health
# => { "ok": true }

// Point the Flutter app to your backend:
static const aiBackendBaseURL = 'http://127.0.0.1:5001';

// For production, use an HTTPS URL.
// During development, localhost is allowed by default on Android
// emulators and iOS simulators.

static const analyticsKey = 'YOUR_GA4_MEASUREMENT_ID';

// That's it. The AnalyticsService initializes automatically
// when Firebase is configured.

// Track custom events anywhere in your app:
AnalyticsService.instance.track(
  'subscription_started',
  parameters: {
    'plan': 'yearly',
    'source': 'paywall',
  },
);

// Request push notification permissions:
await PushMessagingService.instance.requestPermission();

// Schedule a local notification:
await PushMessagingService.instance.scheduleLocal(
  title: 'Time to check in!',
  body: 'Open the app to see what\'s new.',
  delay: const Duration(hours: 1),
);

class ThemeConfig {
  // Change these two values to re-brand the entire app:
  static const primaryHex = '#2563EB';   // Blue
  static const accentHex  = '#06B6D4';   // Cyan

  static ColorScheme get lightScheme => ColorScheme.fromSeed(
    seedColor: Color(
      int.parse(primaryHex.substring(1), radix: 16) + 0xFF000000,
    ),
  );

  static ColorScheme get darkScheme => ColorScheme.fromSeed(
    seedColor: Color(
      int.parse(primaryHex.substring(1), radix: 16) + 0xFF000000,
    ),
    brightness: Brightness.dark,
  );
}

// Access the theme anywhere in your widgets:
final theme = Theme.of(context);

// The theme provides consistent styling:
Text(
  'Hello',
  style: theme.textTheme.headlineMedium?.copyWith(
    color: theme.colorScheme.primary,
  ),
);

// Toggle surface style for a frosted-glass look:
static const surfaceStyle = SurfaceStyle.glass;

# iOS — build a release IPA
flutter build ios

# Android — build a signed App Bundle
flutter build appbundle

# Web — build optimized static files
flutter build web