@intentsolutionsio/fullstack-starter-pack 1.0.0 → 1.0.5

package/commands/auth-setup.md

@@ -14,14 +14,15 @@ Generates complete authentication boilerplate including JWT, OAuth (Google/GitHu
 ## What This Command Does
 
 **Generated Auth System:**
--  JWT authentication with refresh tokens
--  OAuth2 (Google, GitHub, Facebook)
--  Password hashing (bcrypt)
--  Email verification
--  Password reset flow
--  Session management
--  Rate limiting on auth endpoints
--  Authentication middleware
+
+- JWT authentication with refresh tokens
+- OAuth2 (Google, GitHub, Facebook)
+- Password hashing (bcrypt)
+- Email verification
+- Password reset flow
+- Session management
+- Rate limiting on auth endpoints
+- Authentication middleware
 
 **Output:** Complete authentication system ready for production
 
@@ -49,6 +50,7 @@ Generates complete authentication boilerplate including JWT, OAuth (Google/GitHu
 ### **JWT Authentication**
 
 **auth.service.ts:**
+
 ```typescript
 import bcrypt from 'bcrypt'
 import jwt from 'jsonwebtoken'
@@ -201,6 +203,7 @@ export class AuthService {
 ### **OAuth2 Setup (Google)**
 
 **oauth.controller.ts:**
+
 ```typescript
 import { OAuth2Client } from 'google-auth-library'
 
@@ -263,6 +266,7 @@ export class OAuthController {
 ### **Authentication Middleware**
 
 **auth.middleware.ts:**
+
 ```typescript
 import { Request, Response, NextFunction } from 'express'
 import jwt from 'jsonwebtoken'
@@ -419,4 +423,4 @@ export default router
 
 ---
 
-**Secure authentication. Easy integration. Production-ready.** 
+**Secure authentication. Easy integration. Production-ready.**

package/commands/component-generator.md

@@ -14,12 +14,13 @@ Generates production-ready React components from natural language descriptions,
 ## What This Command Does
 
 **Component Generation:**
--  Creates React component with TypeScript
--  Generates prop types and interfaces
--  Adds basic styling (CSS modules or Tailwind)
--  Creates test file (React Testing Library)
--  Includes JSDoc comments
--  Follows React best practices
+
+- Creates React component with TypeScript
+- Generates prop types and interfaces
+- Adds basic styling (CSS modules or Tailwind)
+- Creates test file (React Testing Library)
+- Includes JSDoc comments
+- Follows React best practices
 
 **Output:** Complete component with types, styles, and tests
 
@@ -48,6 +49,7 @@ Generates production-ready React components from natural language descriptions,
 ## Example Output
 
 **Input:**
+
 ```
 /cg "Create a Button component with variants (primary, secondary, ghost), sizes (sm, md, lg), loading state, and icon support"
 ```
@@ -55,6 +57,7 @@ Generates production-ready React components from natural language descriptions,
 **Generated Files:**
 
 **Button.tsx:**
+
 ```tsx
 import { ButtonHTMLAttributes, ReactNode } from 'react'
 import styles from './Button.module.css'
@@ -113,6 +116,7 @@ export function Button({
 ```
 
 **Button.module.css:**
+
 ```css
 .button {
   display: inline-flex;
@@ -183,6 +187,7 @@ export function Button({
 ```
 
 **Button.test.tsx:**
+
 ```tsx
 import { render, screen, fireEvent } from '@testing-library/react'
 import { Button } from './Button'
@@ -238,6 +243,7 @@ describe('Button', () => {
 ### Common Components Generated
 
 **1. Card Component:**
+
 ```tsx
 <Card
   image="/product.jpg"
@@ -248,6 +254,7 @@ describe('Button', () => {
 ```
 
 **2. Modal Component:**
+
 ```tsx
 <Modal
   isOpen={isOpen}
@@ -259,6 +266,7 @@ describe('Button', () => {
 ```
 
 **3. Form Field Component:**
+
 ```tsx
 <FormField
   label="Email"
@@ -269,6 +277,7 @@ describe('Button', () => {
 ```
 
 **4. Dropdown Component:**
+
 ```tsx
 <Dropdown
   items={options}
@@ -283,6 +292,7 @@ describe('Button', () => {
 ## Features
 
 ### Accessibility Built-In
+
 - Semantic HTML elements
 - ARIA attributes where needed
 - Keyboard navigation support
@@ -290,18 +300,21 @@ describe('Button', () => {
 - Screen reader announcements
 
 ### TypeScript Support
+
 - Full type definitions
 - Prop validation
 - IntelliSense support
 - Generic types where appropriate
 
 ### Testing Included
+
 - Unit tests with React Testing Library
 - Accessibility tests
 - User interaction tests
 - Edge case coverage
 
 ### Styling Options
+
 - CSS Modules (default)
 - Tailwind CSS
 - Styled Components
@@ -313,18 +326,21 @@ describe('Button', () => {
 ## Best Practices Applied
 
 **Component Structure:**
+
 - Single responsibility
 - Composable design
 - Prop drilling avoided
 - Performance optimized (React.memo where beneficial)
 
 **Code Quality:**
+
 - ESLint compliant
 - Prettier formatted
 - TypeScript strict mode
 - JSDoc comments
 
 **Testing:**
+
 - 80%+ code coverage
 - User-centric tests (not implementation details)
 - Accessibility assertions

package/commands/css-utility-generator.md

@@ -14,12 +14,13 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ## What This Command Does
 
 **Utility Class Generation:**
--  Spacing utilities (margin, padding)
--  Color utilities (background, text, border)
--  Typography utilities (font size, weight, line height)
--  Layout utilities (flexbox, grid, display)
--  Responsive breakpoints
--  Custom design tokens
+
+- Spacing utilities (margin, padding)
+- Color utilities (background, text, border)
+- Typography utilities (font size, weight, line height)
+- Layout utilities (flexbox, grid, display)
+- Responsive breakpoints
+- Custom design tokens
 
 **Output:** Complete utility CSS file with organized sections
 
@@ -51,6 +52,7 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ## Example Output
 
 **Input:**
+
 ```
 /cug --categories spacing,colors,flex
 ```
@@ -342,6 +344,7 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ## Complete Utility Categories
 
 ### 1. Spacing (Margin & Padding)
+
 ```css
 /* Scale: 0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24 */
 /* Directions: all, t, r, b, l, x, y */
@@ -352,6 +355,7 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ```
 
 ### 2. Typography
+
 ```css
 /* Font Size */
 .text-xs    { font-size: 0.75rem; }
@@ -387,6 +391,7 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ```
 
 ### 3. Layout
+
 ```css
 /* Display */
 .block        { display: block; }
@@ -419,6 +424,7 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ```
 
 ### 4. Grid System
+
 ```css
 /* Grid Template Columns */
 .grid-cols-1  { grid-template-columns: repeat(1, minmax(0, 1fr)); }
@@ -437,6 +443,7 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ```
 
 ### 5. Borders & Radius
+
 ```css
 /* Border Width */
 .border-0 { border-width: 0; }
@@ -460,6 +467,7 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ```
 
 ### 6. Effects
+
 ```css
 /* Shadow */
 .shadow-none { box-shadow: none; }
@@ -482,6 +490,7 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ## Usage Examples
 
 ### Example 1: Card Component
+
 ```html
 <div class="bg-white rounded-lg shadow-md p-6 mb-4">
   <h2 class="text-2xl font-bold mb-2 text-gray-900">Card Title</h2>
@@ -493,6 +502,7 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ```
 
 ### Example 2: Flexbox Layout
+
 ```html
 <div class="flex justify-between items-center p-4 bg-gray-50">
   <div class="flex items-center gap-2">
@@ -508,6 +518,7 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ```
 
 ### Example 3: Responsive Grid
+
 ```html
 <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6 p-8">
   <div class="bg-white p-4 rounded shadow">Item 1</div>
@@ -523,6 +534,7 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ### Design Tokens Configuration
 
 **design-tokens.json:**
+
 ```json
 {
   "colors": {
@@ -565,26 +577,31 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ## Benefits
 
 **1. No Build Step Required**
+
 - Pure CSS, works immediately
 - No JavaScript runtime
 - No npm dependencies
 
 **2. Familiar Syntax**
+
 - Tailwind-like class names
 - Easy to learn for Tailwind users
 - Predictable naming conventions
 
 **3. Customizable**
+
 - Define your own design tokens
 - Choose which categories to include
 - Adjust spacing scales and breakpoints
 
 **4. Lightweight**
+
 - Generate only what you need
 - ~10-50KB depending on categories
 - Much smaller than full Tailwind
 
 **5. Framework Agnostic**
+
 - Works with React, Vue, vanilla HTML
 - No framework lock-in
 - Pure CSS solution
@@ -594,16 +611,19 @@ Generates utility CSS classes similar to Tailwind CSS for common styling needs,
 ## Integration
 
 ### Add to HTML
+
 ```html
 <link rel="stylesheet" href="utilities.css">
 ```
 
 ### Import in CSS
+
 ```css
 @import url('utilities.css');
 ```
 
 ### Import in JavaScript
+
 ```javascript
 import './utilities.css'
 ```
@@ -618,4 +638,4 @@ import './utilities.css'
 
 ---
 
-**Build your design system. Style faster. Ship consistent UIs.** 
+**Build your design system. Style faster. Ship consistent UIs.**

package/commands/env-config-setup.md

@@ -14,12 +14,13 @@ Generates environment configuration files (.env templates, validation schemas, a
 ## What This Command Does
 
 **Generated Configuration:**
--  .env.example (committed template)
--  .env.development, .env.production
--  Config validation schema (Zod)
--  Type-safe config loader
--  Secret management guidance
--  Docker environment setup
+
+- .env.example (committed template)
+- .env.development, .env.production
+- Config validation schema (Zod)
+- Type-safe config loader
+- Secret management guidance
+- Docker environment setup
 
 **Output:** Complete environment configuration system
 
@@ -238,6 +239,7 @@ services:
 ## Security Best Practices
 
 **1. Never Commit Secrets:**
+
 ```bash
 # .gitignore
 .env
@@ -250,6 +252,7 @@ secrets/
 ```
 
 **2. Use Secret Rotation:**
+
 ```bash
 # Rotate secrets regularly
 # Use AWS Secrets Manager, GCP Secret Manager, or Azure Key Vault
@@ -257,6 +260,7 @@ secrets/
 ```
 
 **3. Least Privilege:**
+
 ```bash
 # Only provide necessary permissions
 # Use separate credentials for dev/staging/prod
@@ -264,6 +268,7 @@ secrets/
 ```
 
 **4. Environment Validation:**
+
 ```typescript
 // Validate on startup
 if (process.env.NODE_ENV === 'production') {
@@ -293,6 +298,7 @@ openssl rand -base64 32
 ## Platform-Specific Setup
 
 **Vercel:**
+
 ```bash
 # Set environment variables via CLI
 vercel env add DATABASE_URL production
@@ -300,6 +306,7 @@ vercel env add JWT_SECRET production
 ```
 
 **Railway:**
+
 ```bash
 # Environment variables in dashboard
 # Or via railway.json
@@ -313,6 +320,7 @@ vercel env add JWT_SECRET production
 ```
 
 **AWS ECS:**
+
 ```json
 {
   "containerDefinitions": [{

package/commands/express-api-scaffold.md

@@ -14,15 +14,16 @@ Generates a complete Express.js REST API boilerplate with TypeScript, authentica
 ## What This Command Does
 
 **Generated Project:**
--  Express.js with TypeScript
--  JWT authentication
--  Database integration (Prisma or TypeORM)
--  Input validation (Zod)
--  Error handling middleware
--  Rate limiting & security (Helmet, CORS)
--  Testing setup (Jest + Supertest)
--  Docker configuration
--  Example CRUD endpoints
+
+- Express.js with TypeScript
+- JWT authentication
+- Database integration (Prisma or TypeORM)
+- Input validation (Zod)
+- Error handling middleware
+- Rate limiting & security (Helmet, CORS)
+- Testing setup (Jest + Supertest)
+- Docker configuration
+- Example CRUD endpoints
 
 **Output:** Complete API project ready for development
 
@@ -51,11 +52,13 @@ Generates a complete Express.js REST API boilerplate with TypeScript, authentica
 ## Example Output
 
 **Input:**
+
 ```
 /eas "Task Management API" --database postgresql
 ```
 
 **Generated Project Structure:**
+
 ```
 task-api/
 ├── src/
@@ -585,6 +588,7 @@ describe('Task API', () => {
 ## Features
 
 **Security:**
+
 - Helmet.js for HTTP headers
 - CORS with configurable origins
 - Rate limiting (100 req/15min)
@@ -593,24 +597,28 @@ describe('Task API', () => {
 - Input validation (Zod)
 
 **Database:**
+
 - Prisma ORM with TypeScript
 - Automatic migrations
 - Type-safe queries
 - Supports PostgreSQL, MySQL, SQLite
 
 **Testing:**
+
 - Jest + Supertest
 - Integration tests
 - Coverage reporting
 - Test database isolation
 
 **Development:**
+
 - Hot reload (ts-node-dev)
 - TypeScript with strict mode
 - ESLint + Prettier
 - Environment variables
 
 **Production:**
+
 - Docker support
 - Health check endpoint
 - Error logging
@@ -621,27 +629,32 @@ describe('Task API', () => {
 ## Getting Started
 
 **1. Install dependencies:**
+
 ```bash
 npm install
 ```
 
 **2. Configure environment:**
+
 ```bash
 cp .env.example .env
 # Edit .env with your database URL and secrets
 ```
 
 **3. Run database migrations:**
+
 ```bash
 npm run db:migrate
 ```
 
 **4. Start development server:**
+
 ```bash
 npm run dev
 ```
 
 **5. Run tests:**
+
 ```bash
 npm test
 ```
@@ -656,4 +669,4 @@ npm test
 
 ---
 
-**Build production-ready APIs. Ship faster. Scale confidently.** 
+**Build production-ready APIs. Ship faster. Scale confidently.**

package/commands/fastapi-scaffold.md

@@ -14,15 +14,16 @@ Generates a complete FastAPI REST API boilerplate with async support, authentica
 ## What This Command Does
 
 **Generated Project:**
--  FastAPI with Python 3.10+
--  Async/await throughout
--  JWT authentication
--  Database integration (SQLAlchemy async)
--  Pydantic models & validation
--  Automatic OpenAPI docs
--  Testing setup (Pytest + httpx)
--  Docker configuration
--  Example CRUD endpoints
+
+- FastAPI with Python 3.10+
+- Async/await throughout
+- JWT authentication
+- Database integration (SQLAlchemy async)
+- Pydantic models & validation
+- Automatic OpenAPI docs
+- Testing setup (Pytest + httpx)
+- Docker configuration
+- Example CRUD endpoints
 
 **Output:** Complete API project ready for development
 
@@ -51,11 +52,13 @@ Generates a complete FastAPI REST API boilerplate with async support, authentica
 ## Example Output
 
 **Input:**
+
 ```
 /fas "Task Management API" --database postgresql
 ```
 
 **Generated Project Structure:**
+
 ```
 task-api/
 ├── app/
@@ -601,28 +604,33 @@ mypy==1.8.0
 ## Features
 
 **Performance:**
+
 - Async/await for high concurrency
 - Background tasks support
 - WebSocket support (optional)
 - Automatic Pydantic validation
 
 **Documentation:**
+
 - Auto-generated OpenAPI (Swagger)
 - ReDoc documentation
 - Type hints throughout
 
 **Database:**
+
 - SQLAlchemy ORM with async support
 - Alembic migrations
 - Connection pooling
 
 **Security:**
+
 - JWT authentication
 - Password hashing (bcrypt)
 - CORS middleware
 - Trusted host middleware
 
 **Testing:**
+
 - Pytest with async support
 - Test fixtures
 - Coverage reporting
@@ -632,31 +640,37 @@ mypy==1.8.0
 ## Getting Started
 
 **1. Install dependencies:**
+
 ```bash
 pip install -r requirements.txt
 ```
 
 **2. Configure environment:**
+
 ```bash
 cp .env.example .env
 # Edit .env with your database URL and secrets
 ```
 
 **3. Run database migrations:**
+
 ```bash
 alembic upgrade head
 ```
 
 **4. Start development server:**
+
 ```bash
 uvicorn app.main:app --reload
 ```
 
 **5. View API docs:**
+
 - Swagger UI: http://localhost:8000/api/v1/docs
 - ReDoc: http://localhost:8000/api/v1/redoc
 
 **6. Run tests:**
+
 ```bash
 pytest
 ```
@@ -671,4 +685,4 @@ pytest
 
 ---
 
-**Build high-performance APIs. Scale effortlessly. Deploy confidently.** 
+**Build high-performance APIs. Scale effortlessly. Deploy confidently.**