claudeship 0.2.23 → 0.2.25

package/apps/server/dist/chat/prompts/backend/nestjs.js

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NESTJS_PROMPT = void 0;
+exports.NESTJS_PROMPT = `## Backend: NestJS + TypeScript + Prisma
+
+You are building a NestJS backend with TypeScript and Prisma ORM.
+
+### Technology Stack (Backend)
+
+| Category | Technology | Notes |
+|----------|------------|-------|
+| Runtime | Node.js 20+ | LTS version |
+| Framework | NestJS 10+ | Enterprise-grade |
+| Language | TypeScript | Strict mode |
+| ORM | Prisma | Type-safe database access |
+| Database | SQLite (dev) / PostgreSQL (prod) | |
+| Validation | class-validator | DTO validation |
+
+### Project Structure
+
+\`\`\`
+backend/
+├── src/
+│   ├── main.ts                  # Entry point
+│   ├── app.module.ts            # Root module
+│   ├── prisma/
+│   │   ├── prisma.module.ts
+│   │   └── prisma.service.ts
+│   └── users/
+│       ├── users.module.ts
+│       ├── users.controller.ts
+│       ├── users.service.ts
+│       └── dto/
+│           ├── create-user.dto.ts
+│           └── update-user.dto.ts
+├── prisma/
+│   └── schema.prisma
+├── package.json
+└── tsconfig.json
+\`\`\`
+
+### Backend Setup
+
+\`\`\`bash
+cd backend
+npm init -y
+npm install @nestjs/core @nestjs/common @nestjs/platform-express reflect-metadata rxjs
+npm install class-validator class-transformer
+npm install prisma @prisma/client
+npm install -D typescript @types/node @types/express ts-node
+npx prisma init --datasource-provider sqlite
+\`\`\`
+
+### Main Entry Point
+
+\`\`\`typescript
+// backend/src/main.ts
+import { NestFactory } from '@nestjs/core';
+import { ValidationPipe } from '@nestjs/common';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+
+  app.enableCors({
+    origin: 'http://localhost:3000',
+  });
+
+  app.setGlobalPrefix('api');
+  app.useGlobalPipes(new ValidationPipe({ transform: true }));
+
+  await app.listen(3001);
+  console.log('Server running on http://localhost:3001');
+}
+bootstrap();
+\`\`\`
+
+### App Module
+
+\`\`\`typescript
+// backend/src/app.module.ts
+import { Module } from '@nestjs/common';
+import { PrismaModule } from './prisma/prisma.module';
+import { UsersModule } from './users/users.module';
+
+@Module({
+  imports: [PrismaModule, UsersModule],
+})
+export class AppModule {}
+\`\`\`
+
+### Prisma Service
+
+\`\`\`typescript
+// backend/src/prisma/prisma.service.ts
+import { Injectable, OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { PrismaClient } from '@prisma/client';
+
+@Injectable()
+export class PrismaService extends PrismaClient implements OnModuleInit, OnModuleDestroy {
+  async onModuleInit() {
+    await this.$connect();
+  }
+
+  async onModuleDestroy() {
+    await this.$disconnect();
+  }
+}
+\`\`\`
+
+\`\`\`typescript
+// backend/src/prisma/prisma.module.ts
+import { Module, Global } from '@nestjs/common';
+import { PrismaService } from './prisma.service';
+
+@Global()
+@Module({
+  providers: [PrismaService],
+  exports: [PrismaService],
+})
+export class PrismaModule {}
+\`\`\`
+
+### DTOs with Validation
+
+\`\`\`typescript
+// backend/src/users/dto/create-user.dto.ts
+import { IsString, IsEmail, MinLength } from 'class-validator';
+
+export class CreateUserDto {
+  @IsString()
+  @MinLength(1)
+  name: string;
+
+  @IsEmail()
+  email: string;
+}
+\`\`\`
+
+\`\`\`typescript
+// backend/src/users/dto/update-user.dto.ts
+import { PartialType } from '@nestjs/common';
+import { CreateUserDto } from './create-user.dto';
+
+export class UpdateUserDto extends PartialType(CreateUserDto) {}
+\`\`\`
+
+### Service
+
+\`\`\`typescript
+// backend/src/users/users.service.ts
+import { Injectable, NotFoundException } from '@nestjs/common';
+import { PrismaService } from '../prisma/prisma.service';
+import { CreateUserDto } from './dto/create-user.dto';
+import { UpdateUserDto } from './dto/update-user.dto';
+
+@Injectable()
+export class UsersService {
+  constructor(private prisma: PrismaService) {}
+
+  async findAll() {
+    return this.prisma.user.findMany();
+  }
+
+  async findOne(id: number) {
+    const user = await this.prisma.user.findUnique({ where: { id } });
+    if (!user) {
+      throw new NotFoundException(\`User #\${id} not found\`);
+    }
+    return user;
+  }
+
+  async create(createUserDto: CreateUserDto) {
+    return this.prisma.user.create({ data: createUserDto });
+  }
+
+  async update(id: number, updateUserDto: UpdateUserDto) {
+    await this.findOne(id); // Check existence
+    return this.prisma.user.update({
+      where: { id },
+      data: updateUserDto,
+    });
+  }
+
+  async remove(id: number) {
+    await this.findOne(id); // Check existence
+    return this.prisma.user.delete({ where: { id } });
+  }
+}
+\`\`\`
+
+### Controller
+
+\`\`\`typescript
+// backend/src/users/users.controller.ts
+import {
+  Controller,
+  Get,
+  Post,
+  Put,
+  Delete,
+  Body,
+  Param,
+  ParseIntPipe,
+  HttpCode,
+  HttpStatus,
+} from '@nestjs/common';
+import { UsersService } from './users.service';
+import { CreateUserDto } from './dto/create-user.dto';
+import { UpdateUserDto } from './dto/update-user.dto';
+
+@Controller('users')
+export class UsersController {
+  constructor(private readonly usersService: UsersService) {}
+
+  @Get()
+  findAll() {
+    return this.usersService.findAll();
+  }
+
+  @Get(':id')
+  findOne(@Param('id', ParseIntPipe) id: number) {
+    return this.usersService.findOne(id);
+  }
+
+  @Post()
+  @HttpCode(HttpStatus.CREATED)
+  create(@Body() createUserDto: CreateUserDto) {
+    return this.usersService.create(createUserDto);
+  }
+
+  @Put(':id')
+  update(
+    @Param('id', ParseIntPipe) id: number,
+    @Body() updateUserDto: UpdateUserDto,
+  ) {
+    return this.usersService.update(id, updateUserDto);
+  }
+
+  @Delete(':id')
+  @HttpCode(HttpStatus.NO_CONTENT)
+  remove(@Param('id', ParseIntPipe) id: number) {
+    return this.usersService.remove(id);
+  }
+}
+\`\`\`
+
+### Module
+
+\`\`\`typescript
+// backend/src/users/users.module.ts
+import { Module } from '@nestjs/common';
+import { UsersController } from './users.controller';
+import { UsersService } from './users.service';
+
+@Module({
+  controllers: [UsersController],
+  providers: [UsersService],
+})
+export class UsersModule {}
+\`\`\`
+
+### API Design Guidelines
+
+- **Decorators for everything**: @Controller, @Get, @Post, etc.
+- **DTOs for validation**: Use class-validator decorators
+- **Dependency Injection**: Inject services via constructor
+- **Exception filters**: Use built-in exceptions (NotFoundException, etc.)
+- **Pipes for transformation**: ParseIntPipe, ValidationPipe`;
+//# sourceMappingURL=nestjs.js.map

package/apps/server/dist/chat/prompts/backend/nestjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs.js","sourceRoot":"","sources":["../../../../src/chat/prompts/backend/nestjs.ts"],"names":[],"mappings":";;;AAMa,QAAA,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6DAyQgC,CAAC"}

package/apps/server/dist/chat/prompts/frontend/expo.d.ts

@@ -0,0 +1 @@
+export declare const EXPO_PROMPT = "## Expo (React Native) Development Guide\n\n### Project Structure\n\n```\nfrontend/\n\u251C\u2500\u2500 app/                      # Expo Router pages (file-based routing)\n\u2502   \u251C\u2500\u2500 _layout.tsx          # Root layout\n\u2502   \u251C\u2500\u2500 index.tsx            # Home screen\n\u2502   \u251C\u2500\u2500 (tabs)/              # Tab navigation group\n\u2502   \u2502   \u251C\u2500\u2500 _layout.tsx      # Tab layout\n\u2502   \u2502   \u251C\u2500\u2500 home.tsx\n\u2502   \u2502   \u2514\u2500\u2500 profile.tsx\n\u2502   \u2514\u2500\u2500 [id].tsx             # Dynamic route\n\u251C\u2500\u2500 components/              # Reusable components\n\u2502   \u251C\u2500\u2500 ui/                  # Basic UI components\n\u2502   \u2514\u2500\u2500 features/            # Feature-specific components\n\u251C\u2500\u2500 constants/               # App constants (colors, etc.)\n\u251C\u2500\u2500 hooks/                   # Custom hooks\n\u251C\u2500\u2500 lib/                     # Utilities\n\u251C\u2500\u2500 assets/                  # Images, fonts\n\u251C\u2500\u2500 app.json                 # Expo config\n\u251C\u2500\u2500 package.json\n\u2514\u2500\u2500 tsconfig.json\n```\n\n### Essential Dependencies\n\n```json\n{\n  \"dependencies\": {\n    \"expo\": \"~52.0.0\",\n    \"expo-router\": \"~4.0.0\",\n    \"expo-status-bar\": \"~2.0.0\",\n    \"react\": \"18.3.1\",\n    \"react-native\": \"0.76.0\",\n    \"react-native-safe-area-context\": \"4.12.0\",\n    \"react-native-screens\": \"~4.0.0\",\n    \"react-native-reanimated\": \"~3.16.0\",\n    \"react-native-gesture-handler\": \"~2.20.0\",\n    \"@expo/vector-icons\": \"^14.0.0\"\n  },\n  \"devDependencies\": {\n    \"@babel/core\": \"^7.25.0\",\n    \"@types/react\": \"~18.3.0\",\n    \"typescript\": \"~5.3.0\"\n  }\n}\n```\n\n### Navigation with Expo Router\n\n**Root Layout (_layout.tsx)**:\n```tsx\nimport { Stack } from \"expo-router\";\nimport { StatusBar } from \"expo-status-bar\";\n\nexport default function RootLayout() {\n  return (\n    <>\n      <StatusBar style=\"auto\" />\n      <Stack>\n        <Stack.Screen name=\"index\" options={{ headerShown: false }} />\n        <Stack.Screen name=\"(tabs)\" options={{ headerShown: false }} />\n      </Stack>\n    </>\n  );\n}\n```\n\n**Tab Layout**:\n```tsx\nimport { Tabs } from \"expo-router\";\nimport { Ionicons } from \"@expo/vector-icons\";\n\nexport default function TabLayout() {\n  return (\n    <Tabs screenOptions={{ tabBarActiveTintColor: \"#007AFF\" }}>\n      <Tabs.Screen\n        name=\"home\"\n        options={{\n          title: \"Home\",\n          tabBarIcon: ({ color, size }) => (\n            <Ionicons name=\"home\" size={size} color={color} />\n          ),\n        }}\n      />\n    </Tabs>\n  );\n}\n```\n\n### Styling Approach\n\nUse StyleSheet for performance:\n```tsx\nimport { StyleSheet, View, Text } from \"react-native\";\n\nexport function Card({ title, children }) {\n  return (\n    <View style={styles.card}>\n      <Text style={styles.title}>{title}</Text>\n      {children}\n    </View>\n  );\n}\n\nconst styles = StyleSheet.create({\n  card: {\n    backgroundColor: \"#fff\",\n    borderRadius: 12,\n    padding: 16,\n    shadowColor: \"#000\",\n    shadowOffset: { width: 0, height: 2 },\n    shadowOpacity: 0.1,\n    shadowRadius: 4,\n    elevation: 3,\n  },\n  title: {\n    fontSize: 18,\n    fontWeight: \"600\",\n    marginBottom: 8,\n  },\n});\n```\n\n### API Communication\n\n```tsx\n// lib/api.ts\nconst API_URL = process.env.EXPO_PUBLIC_API_URL || \"http://localhost:3001\";\n\nexport async function fetcher<T>(endpoint: string, options?: RequestInit): Promise<T> {\n  const response = await fetch(`${API_URL}${endpoint}`, {\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...options?.headers,\n    },\n    ...options,\n  });\n\n  if (!response.ok) {\n    throw new Error(`API Error: ${response.status}`);\n  }\n\n  return response.json();\n}\n```\n\n### State Management\n\nUse React Context or Zustand:\n```tsx\n// stores/useAuthStore.ts\nimport { create } from \"zustand\";\n\ninterface AuthState {\n  user: User | null;\n  setUser: (user: User | null) => void;\n}\n\nexport const useAuthStore = create<AuthState>((set) => ({\n  user: null,\n  setUser: (user) => set({ user }),\n}));\n```\n\n### Critical Rules\n\n1. **Always use SafeAreaView** for screen components\n2. **Test on both iOS and Android** - use platform-specific code when needed\n3. **Handle keyboard** with KeyboardAvoidingView for forms\n4. **Use FlatList** for long lists (not ScrollView with map)\n5. **Optimize images** with expo-image or cached images\n6. **Handle loading states** - mobile users expect feedback\n\n### Platform-Specific Code\n\n```tsx\nimport { Platform, StyleSheet } from \"react-native\";\n\nconst styles = StyleSheet.create({\n  container: {\n    paddingTop: Platform.OS === \"ios\" ? 20 : 0,\n    ...Platform.select({\n      ios: { shadowColor: \"#000\" },\n      android: { elevation: 4 },\n    }),\n  },\n});\n```\n\n### Package Scripts\n\n```json\n{\n  \"scripts\": {\n    \"dev\": \"expo start\",\n    \"android\": \"expo start --android\",\n    \"ios\": \"expo start --ios\",\n    \"web\": \"expo start --web\"\n  }\n}\n```";

package/apps/server/dist/chat/prompts/frontend/expo.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPO_PROMPT = void 0;
+exports.EXPO_PROMPT = `## Expo (React Native) Development Guide
+
+### Project Structure
+
+\`\`\`
+frontend/
+├── app/                      # Expo Router pages (file-based routing)
+│   ├── _layout.tsx          # Root layout
+│   ├── index.tsx            # Home screen
+│   ├── (tabs)/              # Tab navigation group
+│   │   ├── _layout.tsx      # Tab layout
+│   │   ├── home.tsx
+│   │   └── profile.tsx
+│   └── [id].tsx             # Dynamic route
+├── components/              # Reusable components
+│   ├── ui/                  # Basic UI components
+│   └── features/            # Feature-specific components
+├── constants/               # App constants (colors, etc.)
+├── hooks/                   # Custom hooks
+├── lib/                     # Utilities
+├── assets/                  # Images, fonts
+├── app.json                 # Expo config
+├── package.json
+└── tsconfig.json
+\`\`\`
+
+### Essential Dependencies
+
+\`\`\`json
+{
+  "dependencies": {
+    "expo": "~52.0.0",
+    "expo-router": "~4.0.0",
+    "expo-status-bar": "~2.0.0",
+    "react": "18.3.1",
+    "react-native": "0.76.0",
+    "react-native-safe-area-context": "4.12.0",
+    "react-native-screens": "~4.0.0",
+    "react-native-reanimated": "~3.16.0",
+    "react-native-gesture-handler": "~2.20.0",
+    "@expo/vector-icons": "^14.0.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.25.0",
+    "@types/react": "~18.3.0",
+    "typescript": "~5.3.0"
+  }
+}
+\`\`\`
+
+### Navigation with Expo Router
+
+**Root Layout (_layout.tsx)**:
+\`\`\`tsx
+import { Stack } from "expo-router";
+import { StatusBar } from "expo-status-bar";
+
+export default function RootLayout() {
+  return (
+    <>
+      <StatusBar style="auto" />
+      <Stack>
+        <Stack.Screen name="index" options={{ headerShown: false }} />
+        <Stack.Screen name="(tabs)" options={{ headerShown: false }} />
+      </Stack>
+    </>
+  );
+}
+\`\`\`
+
+**Tab Layout**:
+\`\`\`tsx
+import { Tabs } from "expo-router";
+import { Ionicons } from "@expo/vector-icons";
+
+export default function TabLayout() {
+  return (
+    <Tabs screenOptions={{ tabBarActiveTintColor: "#007AFF" }}>
+      <Tabs.Screen
+        name="home"
+        options={{
+          title: "Home",
+          tabBarIcon: ({ color, size }) => (
+            <Ionicons name="home" size={size} color={color} />
+          ),
+        }}
+      />
+    </Tabs>
+  );
+}
+\`\`\`
+
+### Styling Approach
+
+Use StyleSheet for performance:
+\`\`\`tsx
+import { StyleSheet, View, Text } from "react-native";
+
+export function Card({ title, children }) {
+  return (
+    <View style={styles.card}>
+      <Text style={styles.title}>{title}</Text>
+      {children}
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  card: {
+    backgroundColor: "#fff",
+    borderRadius: 12,
+    padding: 16,
+    shadowColor: "#000",
+    shadowOffset: { width: 0, height: 2 },
+    shadowOpacity: 0.1,
+    shadowRadius: 4,
+    elevation: 3,
+  },
+  title: {
+    fontSize: 18,
+    fontWeight: "600",
+    marginBottom: 8,
+  },
+});
+\`\`\`
+
+### API Communication
+
+\`\`\`tsx
+// lib/api.ts
+const API_URL = process.env.EXPO_PUBLIC_API_URL || "http://localhost:3001";
+
+export async function fetcher<T>(endpoint: string, options?: RequestInit): Promise<T> {
+  const response = await fetch(\`\${API_URL}\${endpoint}\`, {
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers,
+    },
+    ...options,
+  });
+
+  if (!response.ok) {
+    throw new Error(\`API Error: \${response.status}\`);
+  }
+
+  return response.json();
+}
+\`\`\`
+
+### State Management
+
+Use React Context or Zustand:
+\`\`\`tsx
+// stores/useAuthStore.ts
+import { create } from "zustand";
+
+interface AuthState {
+  user: User | null;
+  setUser: (user: User | null) => void;
+}
+
+export const useAuthStore = create<AuthState>((set) => ({
+  user: null,
+  setUser: (user) => set({ user }),
+}));
+\`\`\`
+
+### Critical Rules
+
+1. **Always use SafeAreaView** for screen components
+2. **Test on both iOS and Android** - use platform-specific code when needed
+3. **Handle keyboard** with KeyboardAvoidingView for forms
+4. **Use FlatList** for long lists (not ScrollView with map)
+5. **Optimize images** with expo-image or cached images
+6. **Handle loading states** - mobile users expect feedback
+
+### Platform-Specific Code
+
+\`\`\`tsx
+import { Platform, StyleSheet } from "react-native";
+
+const styles = StyleSheet.create({
+  container: {
+    paddingTop: Platform.OS === "ios" ? 20 : 0,
+    ...Platform.select({
+      ios: { shadowColor: "#000" },
+      android: { elevation: 4 },
+    }),
+  },
+});
+\`\`\`
+
+### Package Scripts
+
+\`\`\`json
+{
+  "scripts": {
+    "dev": "expo start",
+    "android": "expo start --android",
+    "ios": "expo start --ios",
+    "web": "expo start --web"
+  }
+}
+\`\`\``;
+//# sourceMappingURL=expo.js.map

package/apps/server/dist/chat/prompts/frontend/expo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expo.js","sourceRoot":"","sources":["../../../../src/chat/prompts/frontend/expo.ts"],"names":[],"mappings":";;;AAIa,QAAA,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2MpB,CAAC"}

package/apps/server/dist/chat/prompts/frontend/flutter.d.ts

@@ -0,0 +1 @@
+export declare const FLUTTER_PROMPT = "## Flutter Development Guide\n\n### Project Structure\n\n```\nfrontend/\n\u251C\u2500\u2500 lib/\n\u2502   \u251C\u2500\u2500 main.dart            # Entry point\n\u2502   \u251C\u2500\u2500 app.dart             # App widget with routing\n\u2502   \u251C\u2500\u2500 screens/             # Screen widgets\n\u2502   \u2502   \u251C\u2500\u2500 home_screen.dart\n\u2502   \u2502   \u2514\u2500\u2500 profile_screen.dart\n\u2502   \u251C\u2500\u2500 widgets/             # Reusable widgets\n\u2502   \u2502   \u251C\u2500\u2500 common/          # Generic widgets\n\u2502   \u2502   \u2514\u2500\u2500 features/        # Feature-specific widgets\n\u2502   \u251C\u2500\u2500 models/              # Data models\n\u2502   \u251C\u2500\u2500 services/            # API, storage services\n\u2502   \u251C\u2500\u2500 providers/           # State management\n\u2502   \u251C\u2500\u2500 utils/               # Utilities\n\u2502   \u2514\u2500\u2500 constants/           # App constants\n\u251C\u2500\u2500 assets/                  # Images, fonts\n\u251C\u2500\u2500 android/                 # Android config\n\u251C\u2500\u2500 ios/                     # iOS config\n\u251C\u2500\u2500 pubspec.yaml             # Dependencies\n\u2514\u2500\u2500 analysis_options.yaml    # Lint rules\n```\n\n### Essential Dependencies (pubspec.yaml)\n\n```yaml\ndependencies:\n  flutter:\n    sdk: flutter\n  go_router: ^14.0.0          # Navigation\n  provider: ^6.1.0            # State management\n  dio: ^5.4.0                 # HTTP client\n  flutter_riverpod: ^2.5.0    # Alternative state management\n  freezed_annotation: ^2.4.0  # Immutable models\n  json_annotation: ^4.8.0     # JSON serialization\n\ndev_dependencies:\n  flutter_test:\n    sdk: flutter\n  flutter_lints: ^4.0.0\n  build_runner: ^2.4.0\n  freezed: ^2.4.0\n  json_serializable: ^6.7.0\n```\n\n### App Entry Point\n\n```dart\n// lib/main.dart\nimport 'package:flutter/material.dart';\nimport 'package:provider/provider.dart';\nimport 'app.dart';\nimport 'providers/auth_provider.dart';\n\nvoid main() {\n  runApp(\n    MultiProvider(\n      providers: [\n        ChangeNotifierProvider(create: (_) => AuthProvider()),\n      ],\n      child: const MyApp(),\n    ),\n  );\n}\n```\n\n### Navigation with go_router\n\n```dart\n// lib/app.dart\nimport 'package:flutter/material.dart';\nimport 'package:go_router/go_router.dart';\n\nfinal _router = GoRouter(\n  initialLocation: '/',\n  routes: [\n    GoRoute(\n      path: '/',\n      builder: (context, state) => const HomeScreen(),\n    ),\n    GoRoute(\n      path: '/profile/:id',\n      builder: (context, state) {\n        final id = state.pathParameters['id']!;\n        return ProfileScreen(userId: id);\n      },\n    ),\n  ],\n);\n\nclass MyApp extends StatelessWidget {\n  const MyApp({super.key});\n\n  @override\n  Widget build(BuildContext context) {\n    return MaterialApp.router(\n      title: 'My App',\n      theme: ThemeData(\n        colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),\n        useMaterial3: true,\n      ),\n      routerConfig: _router,\n    );\n  }\n}\n```\n\n### Screen Widget Pattern\n\n```dart\n// lib/screens/home_screen.dart\nimport 'package:flutter/material.dart';\nimport 'package:go_router/go_router.dart';\n\nclass HomeScreen extends StatefulWidget {\n  const HomeScreen({super.key});\n\n  @override\n  State<HomeScreen> createState() => _HomeScreenState();\n}\n\nclass _HomeScreenState extends State<HomeScreen> {\n  List<Item> _items = [];\n  bool _isLoading = true;\n\n  @override\n  void initState() {\n    super.initState();\n    _loadItems();\n  }\n\n  Future<void> _loadItems() async {\n    try {\n      final items = await ApiService.getItems();\n      setState(() {\n        _items = items;\n        _isLoading = false;\n      });\n    } catch (e) {\n      setState(() => _isLoading = false);\n      // Handle error\n    }\n  }\n\n  @override\n  Widget build(BuildContext context) {\n    return Scaffold(\n      appBar: AppBar(title: const Text('Home')),\n      body: _isLoading\n          ? const Center(child: CircularProgressIndicator())\n          : ListView.builder(\n              itemCount: _items.length,\n              itemBuilder: (context, index) {\n                final item = _items[index];\n                return ListTile(\n                  title: Text(item.name),\n                  onTap: () => context.go('/details/${item.id}'),\n                );\n              },\n            ),\n    );\n  }\n}\n```\n\n### Data Models with Freezed\n\n```dart\n// lib/models/user.dart\nimport 'package:freezed_annotation/freezed_annotation.dart';\n\npart 'user.freezed.dart';\npart 'user.g.dart';\n\n@freezed\nclass User with _$User {\n  const factory User({\n    required String id,\n    required String name,\n    required String email,\n  }) = _User;\n\n  factory User.fromJson(Map<String, dynamic> json) => _$UserFromJson(json);\n}\n```\n\n### API Service with Dio\n\n```dart\n// lib/services/api_service.dart\nimport 'package:dio/dio.dart';\n\nclass ApiService {\n  static final _dio = Dio(BaseOptions(\n    baseUrl: const String.fromEnvironment('API_URL', defaultValue: 'http://localhost:3001'),\n    connectTimeout: const Duration(seconds: 10),\n    receiveTimeout: const Duration(seconds: 10),\n  ));\n\n  static Future<List<Item>> getItems() async {\n    final response = await _dio.get('/items');\n    return (response.data as List)\n        .map((json) => Item.fromJson(json))\n        .toList();\n  }\n\n  static Future<Item> createItem(CreateItemInput input) async {\n    final response = await _dio.post('/items', data: input.toJson());\n    return Item.fromJson(response.data);\n  }\n}\n```\n\n### State Management with Provider\n\n```dart\n// lib/providers/auth_provider.dart\nimport 'package:flutter/material.dart';\nimport '../models/user.dart';\n\nclass AuthProvider extends ChangeNotifier {\n  User? _user;\n\n  User? get user => _user;\n  bool get isLoggedIn => _user != null;\n\n  void setUser(User user) {\n    _user = user;\n    notifyListeners();\n  }\n\n  void logout() {\n    _user = null;\n    notifyListeners();\n  }\n}\n```\n\n### Critical Rules\n\n1. **Use const constructors** for performance optimization\n2. **Separate business logic** from UI (use services/providers)\n3. **Use StatelessWidget** when no local state is needed\n4. **Run build_runner** after changing Freezed models: `dart run build_runner build`\n5. **Test on both iOS and Android** - platform-specific issues are common\n6. **Handle async errors** with try-catch and show user feedback\n\n### Package Scripts\n\nAdd these to your workflow:\n```bash\n# Run app\nflutter run\n\n# Build runner for code generation\ndart run build_runner build --delete-conflicting-outputs\n\n# Analyze code\nflutter analyze\n\n# Run tests\nflutter test\n```";