devendra-skill-package 1.0.2

package/.github/skills/boiler-project-generator/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: boiler-project-generator
+description: 'MUST be used to create a boiler project, boiler plate project, or boilerplate project for a chosen framework (Angular, React, React Native, Flutter, etc.). Use when the user asks to create, generate, scaffold, or bootstrap a starter app and you need to ask for framework, language, template, and project name.'
+argument-hint: 'Describe the boilerplate project to scaffold'
+user-invocable: true
+---
+ 
+# Boiler Project Generator
+
+## Purpose
+
+Generate a reproducible starter project (boilerplate) for a chosen framework and language. The skill is execution-focused and delegates framework-specific steps to scripts and reference guides.
+
+## Trigger Conditions
+
+Use this skill when the user requests to:
+- Create or scaffold a new project (starter app)
+- Generate boilerplate for a framework (Angular, React, React Native, etc.)
+- Bootstrap a minimal app with specified language and project name
+
+## Inputs
+
+- `framework` (optional): `angular | react | react-native | other` — preferred framework
+- `language` (optional): `javascript | typescript` — preferred language
+- `projectName` (optional): desired project folder name
+- `options` (optional): additional flags passed to generator scripts
+
+## References
+
+- `references/angular.md` — Angular-specific guidance and validation notes
+- `references/react.md` — React-specific notes (if present)
+- `references/react-native.md` — React Native notes (if present)
+ - `references/ios.md` — iOS build & CI guidance
+ - `references/android.md` — Android build & CI guidance
+ - `references/flutter.md` — Flutter post-generation guidance
+
+## Assets
+
+- `assets/templates/react-native/` — React Native source templates (screens, components, navigation, redux, api, env, theme, hooks, utils) applied by `scripts/react-native.js`
+- Other framework templates and defaults may be stored under `assets/` as needed.
+
+## Scripts
+
+- `scripts/generate-project.mjs` — canonical CLI entrypoint; supports `--framework`, `--language`, `--project`, `--template`, `--dry-run`, `--force`, and produces deterministic JSON reports in `artifacts/boiler-generator/`.
+- `scripts/init.js` — interactive orchestrator (platform-agnostic driver)
+- `scripts/angular.js` — Angular-specific generator script (framework implementation)
+- `scripts/react.js` — React-specific generator script
+- `scripts/react-native.js` — React Native production-ready generator with interactive prompts for navigation, redux, env config, and platform verification; uses templates from `assets/templates/react-native/`
+
+## Execution Steps
+
+1. Collect missing inputs: `framework`, `language`, `projectName` via prompts if not provided.
+2. Validate inputs for allowed values and sanitize `projectName`.
+3. Invoke `scripts/init.js` to dispatch to the framework-specific generator. All additional CLI flags (e.g. `--enableNavigation`, `--enableRedux`) are forwarded to the child script.
+4. After generation, run framework-specific validation from inside the generated project directory (see `references/*` for each framework's post-generation steps).
+5. Print a summary of created files, installed packages, and verification results. When using `scripts/generate-project.mjs`, a deterministic JSON report is also emitted.
+
+## Agent Behavior
+
+- Always pass ALL flags in a single non-interactive command. Do not rely on interactive prompts.
+- For React Native, call `scripts/react-native.js` directly with all flags for the most reliable flow.
+- Do NOT interrupt the script while packages are installing. The script prints numbered progress steps `[1/6]` through `[6/6]` — wait for the full sequence to complete.
+- If the terminal appears idle during `react-native init` or `npm install`, the script is still running. Wait for it.
+- The script verifies dependency compatibility after all installs. Do not start manual fixes before the script finishes.
+
+## Rules
+
+- SKILL.md MUST NOT contain platform-specific implementation details; those belong in `references/` and `scripts/`.
+- Do not hardcode absolute paths — use relative references and the workspace root.
+- Scripts MUST be idempotent and support a `--help` flag.
+- Generated output must be deterministic given the same inputs and script versions.
+
+## Output Format
+
+The skill produces a machine-readable JSON summary with fields:
+
+```json
+{
+	"projectName": "<name>",
+	"framework": "<framework>",
+	"language": "<lang>",
+	"status": "success|failed",
+	"steps": [ { "step": "init", "ok": true, "details": "..." } ]
+}
+```
+
+Human-readable HTML report generation is optional and performed by scripts if requested.
+
+## Examples
+
+User request: "Create a React TypeScript starter named MyApp"
+
+```
+node ./.github/skills/boiler-project-generator/scripts/init.js --framework react --language typescript --project MyApp
+```
+
+User request: "Create a React Native app named TradeDesk with navigation and Redux"
+
+```
+node ./.github/skills/boiler-project-generator/scripts/react-native.js --project TradeDesk --language typescript --enableNavigation yes --enableRedux yes --enableEnv yes --verificationTarget none
+```
+
+See `references/angular.md` for Angular-specific and `references/react-native.md` for React Native-specific guidance.

package/.github/skills/boiler-project-generator/assets/templates/android/README.md

@@ -0,0 +1,3 @@
+# Android templates
+
+Place Android-specific project snippets and CI notes here. Scripts will look up templates by name under this directory.

package/.github/skills/boiler-project-generator/assets/templates/angular/README.md

@@ -0,0 +1,3 @@
+# Angular templates
+
+Place Angular starter templates and config snippets here. Scripts will look up templates by name under this directory.

package/.github/skills/boiler-project-generator/assets/templates/flutter/README.md

@@ -0,0 +1,3 @@
+# Flutter templates
+
+Place Flutter starter templates and config snippets here. Scripts will look up templates by name under this directory.

package/.github/skills/boiler-project-generator/assets/templates/ios/README.md

@@ -0,0 +1,3 @@
+# iOS templates
+
+Place iOS-specific project snippets and CI notes here. Scripts will look up templates by name under this directory.

package/.github/skills/boiler-project-generator/assets/templates/react/README.md

@@ -0,0 +1,3 @@
+# React templates
+
+Place React starter templates and config snippets here. Scripts will look up templates by name under this directory.

package/.github/skills/boiler-project-generator/assets/templates/react-native/README.md

@@ -0,0 +1,3 @@
+# React Native templates
+
+Place React Native starter templates and config snippets here. Scripts will look up templates by name under this directory.

package/.github/skills/boiler-project-generator/assets/templates/react-native/api-setup.ts

@@ -0,0 +1,76 @@
+import axios, {
+	AxiosError,
+	AxiosInstance,
+	AxiosResponse,
+	InternalAxiosRequestConfig,
+} from 'axios';
+import Config from 'react-native-config';
+
+const API_BASE_URL = Config.API_BASE_URL || 'https://api.example.com';
+const API_TIMEOUT_MS = 30000;
+
+type ErrorPayload = {
+	message?: string;
+	code?: string;
+};
+
+export class ApiError extends Error {
+	status?: number;
+	code?: string;
+
+	constructor(message: string, status?: number, code?: string) {
+		super(message);
+		this.name = 'ApiError';
+		this.status = status;
+		this.code = code;
+	}
+}
+
+class ApiService {
+	private instance: AxiosInstance;
+	private token: string | null = null;
+
+	constructor() {
+		this.instance = axios.create({
+			baseURL: API_BASE_URL,
+			timeout: API_TIMEOUT_MS,
+			headers: {
+				'Content-Type': 'application/json',
+				Accept: 'application/json',
+			},
+		});
+
+		this.setupInterceptors();
+	}
+
+	setAuthToken(token: string | null): void {
+		this.token = token;
+	}
+
+	private setupInterceptors(): void {
+		this.instance.interceptors.request.use((config: InternalAxiosRequestConfig) => {
+			const nextConfig = {...config};
+			if (this.token) {
+				nextConfig.headers.set('Authorization', `Bearer ${this.token}`);
+			}
+			return nextConfig;
+		});
+
+		this.instance.interceptors.response.use(
+			(response: AxiosResponse) => response,
+			(error: AxiosError<ErrorPayload>) => {
+				const status = error.response?.status;
+				const code = error.response?.data?.code;
+				const message =
+					error.response?.data?.message || error.message || 'Unexpected API error';
+				return Promise.reject(new ApiError(message, status, code));
+			},
+		);
+	}
+
+	get client(): AxiosInstance {
+		return this.instance;
+	}
+}
+
+export const apiService = new ApiService();

package/.github/skills/boiler-project-generator/assets/templates/react-native/component-primary-button.tsx

@@ -0,0 +1,29 @@
+import React from 'react';
+import {Pressable, StyleSheet, Text} from 'react-native';
+
+type Props = {
+  title: string;
+  onPress: () => void;
+};
+
+export default function PrimaryButton({title, onPress}: Props): React.JSX.Element {
+  return (
+    <Pressable style={styles.button} onPress={onPress}>
+      <Text style={styles.label}>{title}</Text>
+    </Pressable>
+  );
+}
+
+const styles = StyleSheet.create({
+  button: {
+    backgroundColor: '#0F172A',
+    paddingVertical: 12,
+    paddingHorizontal: 16,
+    borderRadius: 8,
+  },
+  label: {
+    color: '#FFFFFF',
+    fontSize: 16,
+    fontWeight: '600',
+  },
+});

package/.github/skills/boiler-project-generator/assets/templates/react-native/env-config.env

@@ -0,0 +1,4 @@
+API_BASE_URL=__API_BASE_URL__
+API_TIMEOUT_MS=30000
+APP_ENV=__APP_ENV__
+SENTRY_DSN=

package/.github/skills/boiler-project-generator/assets/templates/react-native/feature-auth-screen.tsx

@@ -0,0 +1,45 @@
+import {NativeStackScreenProps} from '@react-navigation/native-stack';
+import React from 'react';
+import {Pressable, StyleSheet, Text, View} from 'react-native';
+
+import {RootStackParamList} from '../../navigation/RootNavigator';
+
+type Props = NativeStackScreenProps<RootStackParamList, 'Auth'>;
+
+export default function AuthScreen({navigation}: Props): React.JSX.Element {
+  return (
+    <View style={styles.container}>
+      <Text style={styles.title}>Auth</Text>
+      <Text>Implement login and session bootstrap here.</Text>
+      <Pressable style={styles.button} onPress={() => navigation.navigate('Dashboard')}>
+        <Text style={styles.buttonText}>Continue to Dashboard</Text>
+      </Pressable>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    justifyContent: 'center',
+    alignItems: 'center',
+    paddingHorizontal: 24,
+  },
+  title: {
+    fontSize: 24,
+    fontWeight: '700',
+    marginBottom: 12,
+  },
+  button: {
+    marginTop: 24,
+    backgroundColor: '#111E58',
+    paddingVertical: 12,
+    paddingHorizontal: 32,
+    borderRadius: 5,
+  },
+  buttonText: {
+    color: '#FFFFFF',
+    fontSize: 14,
+    fontWeight: '700',
+  },
+});

package/.github/skills/boiler-project-generator/assets/templates/react-native/feature-dashboard-screen.tsx

@@ -0,0 +1,45 @@
+import {NativeStackScreenProps} from '@react-navigation/native-stack';
+import React from 'react';
+import {Pressable, StyleSheet, Text, View} from 'react-native';
+
+import {RootStackParamList} from '../../navigation/RootNavigator';
+
+type Props = NativeStackScreenProps<RootStackParamList, 'Dashboard'>;
+
+export default function DashboardScreen({navigation}: Props): React.JSX.Element {
+  return (
+    <View style={styles.container}>
+      <Text style={styles.title}>Dashboard</Text>
+      <Text>Business widgets and summary cards go here.</Text>
+      <Pressable style={styles.button} onPress={() => navigation.navigate('Profile')}>
+        <Text style={styles.buttonText}>Go to Profile</Text>
+      </Pressable>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    justifyContent: 'center',
+    alignItems: 'center',
+    paddingHorizontal: 24,
+  },
+  title: {
+    fontSize: 24,
+    fontWeight: '700',
+    marginBottom: 12,
+  },
+  button: {
+    marginTop: 24,
+    backgroundColor: '#111E58',
+    paddingVertical: 12,
+    paddingHorizontal: 32,
+    borderRadius: 5,
+  },
+  buttonText: {
+    color: '#FFFFFF',
+    fontSize: 14,
+    fontWeight: '700',
+  },
+});

package/.github/skills/boiler-project-generator/assets/templates/react-native/feature-profile-screen.tsx

@@ -0,0 +1,45 @@
+import {NativeStackScreenProps} from '@react-navigation/native-stack';
+import React from 'react';
+import {Pressable, StyleSheet, Text, View} from 'react-native';
+
+import {RootStackParamList} from '../../navigation/RootNavigator';
+
+type Props = NativeStackScreenProps<RootStackParamList, 'Profile'>;
+
+export default function ProfileScreen({navigation}: Props): React.JSX.Element {
+  return (
+    <View style={styles.container}>
+      <Text style={styles.title}>Profile</Text>
+      <Text>User details and preferences screen.</Text>
+      <Pressable style={styles.button} onPress={() => navigation.goBack()}>
+        <Text style={styles.buttonText}>Go Back</Text>
+      </Pressable>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    justifyContent: 'center',
+    alignItems: 'center',
+    paddingHorizontal: 24,
+  },
+  title: {
+    fontSize: 24,
+    fontWeight: '700',
+    marginBottom: 12,
+  },
+  button: {
+    marginTop: 24,
+    backgroundColor: '#111E58',
+    paddingVertical: 12,
+    paddingHorizontal: 32,
+    borderRadius: 5,
+  },
+  buttonText: {
+    color: '#FFFFFF',
+    fontSize: 14,
+    fontWeight: '700',
+  },
+});

package/.github/skills/boiler-project-generator/assets/templates/react-native/hook-use-app-boot.ts

@@ -0,0 +1,11 @@
+import {useEffect, useState} from 'react';
+
+export function useAppBoot(): {isReady: boolean} {
+  const [isReady, setReady] = useState(false);
+
+  useEffect(() => {
+    setReady(true);
+  }, []);
+
+  return {isReady};
+}

package/.github/skills/boiler-project-generator/assets/templates/react-native/navigation-setup.tsx

@@ -0,0 +1,25 @@
+import React from 'react';
+import {
+	createNativeStackNavigator,
+} from '@react-navigation/native-stack';
+import AuthScreen from '../features/auth/AuthScreen';
+import DashboardScreen from '../features/dashboard/DashboardScreen';
+import ProfileScreen from '../features/profile/ProfileScreen';
+
+export type RootStackParamList = {
+	Auth: undefined;
+	Dashboard: undefined;
+	Profile: undefined;
+};
+
+const Stack = createNativeStackNavigator<RootStackParamList>();
+
+export default function RootNavigator(): React.JSX.Element {
+	return (
+		<Stack.Navigator screenOptions={{headerBackTitle: 'Back'}}>
+			<Stack.Screen name="Auth" component={AuthScreen} />
+			<Stack.Screen name="Dashboard" component={DashboardScreen} />
+			<Stack.Screen name="Profile" component={ProfileScreen} />
+		</Stack.Navigator>
+	);
+}

package/.github/skills/boiler-project-generator/assets/templates/react-native/project-structure.md

@@ -0,0 +1,24 @@
+src/
+	features/
+		auth/
+			AuthScreen.tsx
+			sessionSlice.ts
+		dashboard/
+			DashboardScreen.tsx
+		profile/
+			ProfileScreen.tsx
+	components/
+		PrimaryButton.tsx
+	services/
+		api.ts
+	navigation/
+		RootNavigator.tsx
+	hooks/
+		useAppBoot.ts
+	utils/
+		helpers.ts
+	theme/
+		index.ts
+	store/
+		store.ts
+		hooks.ts

package/.github/skills/boiler-project-generator/assets/templates/react-native/redux-hooks.ts

@@ -0,0 +1,5 @@
+import {TypedUseSelectorHook, useDispatch, useSelector} from 'react-redux';
+import type {AppDispatch, RootState} from './store';
+
+export const useAppDispatch = (): AppDispatch => useDispatch<AppDispatch>();
+export const useAppSelector: TypedUseSelectorHook<RootState> = useSelector;

package/.github/skills/boiler-project-generator/assets/templates/react-native/redux-session-slice.ts

@@ -0,0 +1,29 @@
+import {createSlice, PayloadAction} from '@reduxjs/toolkit';
+
+type SessionState = {
+  isAuthenticated: boolean;
+  token: string | null;
+};
+
+const initialState: SessionState = {
+  isAuthenticated: false,
+  token: null,
+};
+
+const sessionSlice = createSlice({
+  name: 'session',
+  initialState,
+  reducers: {
+    setSession(state, action: PayloadAction<{token: string}>) {
+      state.isAuthenticated = true;
+      state.token = action.payload.token;
+    },
+    clearSession(state) {
+      state.isAuthenticated = false;
+      state.token = null;
+    },
+  },
+});
+
+export const {setSession, clearSession} = sessionSlice.actions;
+export default sessionSlice.reducer;

package/.github/skills/boiler-project-generator/assets/templates/react-native/redux-store.ts

@@ -0,0 +1,15 @@
+import {configureStore} from '@reduxjs/toolkit';
+import sessionReducer from '../features/auth/sessionSlice';
+
+export const store = configureStore({
+  reducer: {
+    session: sessionReducer,
+  },
+  middleware: getDefaultMiddleware =>
+    getDefaultMiddleware({
+      serializableCheck: true,
+    }),
+});
+
+export type RootState = ReturnType<typeof store.getState>;
+export type AppDispatch = typeof store.dispatch;

package/.github/skills/boiler-project-generator/assets/templates/react-native/theme-index.ts

@@ -0,0 +1,23 @@
+export const colors = {
+  background: '#FFFFFF',
+  surface: '#F8FAFC',
+  textPrimary: '#0F172A',
+  textSecondary: '#475569',
+  primary: '#0EA5E9',
+  danger: '#DC2626',
+};
+
+export const typography = {
+  h1: 28,
+  h2: 22,
+  body: 16,
+  caption: 13,
+};
+
+export const spacing = {
+  xs: 4,
+  sm: 8,
+  md: 16,
+  lg: 24,
+  xl: 32,
+};

package/.github/skills/boiler-project-generator/assets/templates/react-native/utils-helpers.ts

@@ -0,0 +1,7 @@
+export function formatCurrency(value: number, currency = 'USD'): string {
+  return new Intl.NumberFormat('en-US', {
+    style: 'currency',
+    currency,
+    maximumFractionDigits: 2,
+  }).format(value);
+}

package/.github/skills/boiler-project-generator/metadata.yaml

@@ -0,0 +1,29 @@
+name: boiler-project-generator
+version: 1.0.0
+status: active
+category: generator
+platforms:
+  - angular
+  - react
+  - react-native
+  - ios
+  - android
+  - flutter
+
+tags:
+  - boilerplate
+  - generator
+  - templates
+  - scaffold
+  - cli
+
+owner: Himanshu-skill-development-team
+
+changelog:
+  - version: 1.0.0
+    date: 2026-04-28
+    changes:
+      - Refactored angular-only skill into cross-platform boiler-project-generator
+      - Added CLI flags, template support, and assets/templates placeholders
+      - Created framework references for platform-specific validation guidance
+      - Added deterministic JSON report output and CI smoke workflow

package/.github/skills/boiler-project-generator/references/android.md

@@ -0,0 +1,19 @@
+# Android Reference: Post-generation Validation and Notes
+
+This reference contains Android-specific guidance for the `boiler-project-generator` skill. Use these steps only when `framework=android` or when generating native Android projects.
+
+1. After the generator finishes, change directory into the generated project: `cd <projectName>`.
+2. Ensure the correct Java/JDK version is installed (check `build.gradle` `java`/`jdk` compatibility). Install via SDK manager or system package manager.
+3. Install Android SDK tools and set `ANDROID_HOME` / `ANDROID_SDK_ROOT` environment variables.
+4. Install platform dependencies: run `./gradlew dependencies` or `gradlew.bat dependencies` on Windows.
+5. Build the project locally: `./gradlew assembleDebug` (or use `gradlew.bat` on Windows).
+6. Run unit tests: `./gradlew test` and instrumented tests via an emulator or connected device: `./gradlew connectedAndroidTest`.
+
+Validation notes
+- Confirm `gradle` wrapper is present and executable (`gradlew` / `gradlew.bat`).
+- Use `--stacktrace` for verbose failure diagnostics when troubleshooting builds.
+- Capture build and test logs and include them in the skill JSON report.
+
+CI guidance
+- In CI, ensure the build image includes required JDK and Android SDK components, or use an Android CI image (e.g., `reactnativecommunity/android` or custom image).
+- Use `./gradlew assembleRelease` with proper signing configuration only in controlled CI environments.

package/.github/skills/boiler-project-generator/references/angular.md

@@ -0,0 +1,14 @@
+# Angular Reference: Post-generation Validation and Notes
+
+This file contains Angular-specific guidance for the `boiler-project-generator` skill. The generic `SKILL.md` intentionally avoids platform specifics — follow the steps in this reference when `framework=angular`.
+
+1. After the generator finishes, change directory into the generated project: `cd <projectName>`.
+2. Disable Angular CLI analytics in CI: `export NG_CLI_ANALYTICS=false` (or set `NG_CLI_ANALYTICS=false` in the environment).
+3. Run a local build to validate the generated app: `npm run build` (or `ng build` inside the project directory).
+4. If TypeScript is required, note that Angular CLI generates TypeScript projects by default.
+5. For CI, ensure `node` and `npm` versions match the project requirements and `npm ci` is used to install reproducible dependencies.
+
+Validation notes
+- Run `npm run build` from within the generated project folder — not from the skill repository root.
+- Check `package.json` scripts and `engines` to determine required runtimes.
+- Capture build logs and return them as part of the skill's JSON report.

package/.github/skills/boiler-project-generator/references/flutter.md

@@ -0,0 +1,17 @@
+# Flutter Reference: Post-generation Validation and Notes
+
+This reference contains Flutter-specific guidance for the `boiler-project-generator` skill. Use these steps only when `framework=flutter` or generating Flutter projects.
+
+1. After the generator finishes, change directory into the generated project: `cd <projectName>`.
+2. Ensure the correct Flutter SDK is installed and on `PATH`: `flutter --version`.
+3. Run `flutter pub get` to install dependencies.
+4. Validate the project with `flutter analyze` and run tests with `flutter test`.
+5. Build the app for target platforms: `flutter build apk` (Android) or `flutter build ios` (iOS, macOS required).
+
+Validation notes
+- Use `flutter doctor` to detect common environment problems and include its output in the skill report.
+- Capture analyzer warnings and test results for inclusion in the JSON report.
+
+CI guidance
+- Use official Flutter CI images or configure runners with Flutter SDK installed.
+- For iOS builds, CI must run on macOS machines with Xcode installed.

package/.github/skills/boiler-project-generator/references/ios.md

@@ -0,0 +1,17 @@
+# iOS Reference: Post-generation Validation and Notes
+
+This reference contains iOS-specific guidance for the `boiler-project-generator` skill. Use these steps only when `framework=ios` or generating iOS projects.
+
+1. After the generator finishes, change directory into the generated project: `cd <projectName>`.
+2. Ensure Xcode is installed (macOS only) and command line tools are available.
+3. Install CocoaPods dependencies (if present): `cd ios && pod install`.
+4. Build the project locally via Xcode or CLI: `xcodebuild -workspace <Workspace>.xcworkspace -scheme <Scheme> -sdk iphonesimulator -configuration Debug`.
+5. Run unit tests via Xcode or `xcodebuild test` with an appropriate simulator.
+
+Validation notes
+- Confirm `Podfile` and `Podfile.lock` are present when CocoaPods are used.
+- Capture build logs and simulator test output and include them in the skill JSON report.
+
+CI guidance
+- CI for iOS must run on macOS runners or dedicated macOS build machines.
+- Use `xcodebuild -list` to discover schemes and use `xcodebuild test` with `-destination` to target simulators.