diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..3bde89c
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,140 @@
+# ============================================
+# SysMVC - Environment Variables Example
+# Copy this file to .env and fill in your values
+# ============================================
+
+# -------------------------------------------
+# Application Settings
+# -------------------------------------------
+APP_NAME=SysMVC
+APP_KEY=your_64_character_app_key_here
+APP_ENV=production
+APP_DEBUG=false
+APP_URL=http://localhost:16270
+
+# -------------------------------------------
+# Database Configuration
+# -------------------------------------------
+DB_CONNECTION=mysql
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_DATABASE=sysmvc
+DB_USERNAME=root
+DB_PASSWORD=
+
+# -------------------------------------------
+# Session Configuration
+# -------------------------------------------
+SESSION_DRIVER=file
+SESSION_LIFETIME=120
+
+# -------------------------------------------
+# Mail Configuration (SMTP)
+# -------------------------------------------
+MAIL_MAILER=smtp
+MAIL_HOST=sandbox.smtp.mailtrap.io
+MAIL_PORT=2525
+MAIL_USERNAME=your_mail_username
+MAIL_PASSWORD=your_mail_password
+MAIL_ENCRYPTION=tls
+MAIL_FROM_ADDRESS=noreply@example.com
+MAIL_FROM_NAME="${APP_NAME}"
+
+# -------------------------------------------
+# Logging Configuration
+# -------------------------------------------
+LOG_CHANNEL=stack
+
+# -------------------------------------------
+# JWT Secret (for authentication)
+# -------------------------------------------
+JWT_SECRET=your_jwt_secret_key_here
+
+# -------------------------------------------
+# Redis Configuration
+# -------------------------------------------
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+REDIS_DB=0
+
+# -------------------------------------------
+# Payment Gateways
+# -------------------------------------------
+# Stripe
+STRIPE_SECRET_KEY=your_stripe_secret_key
+STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key
+
+# PayPal
+PAYPAL_CLIENT_ID=your_paypal_client_id
+PAYPAL_SECRET=your_paypal_secret_key
+PAYPAL_MODE=sandbox
+
+# MercadoPago
+MERCADOPAGO_ACCESS_TOKEN=your_access_token
+MERCADOPAGO_PUBLIC_KEY=your_public_key
+
+# Pagar.me
+PAGARME_API_KEY=your_api_key
+PAGARME_ENCRYPTION_KEY=your_encryption_key
+
+# Braintree
+BRAINTREE_MERCHANT_ID=your_merchant_id
+BRAINTREE_PUBLIC_KEY=your_public_key
+BRAINTREE_PRIVATE_KEY=your_private_key
+
+# PagSeguro
+PAGSEGURO_EMAIL=your_pagseguro_email
+PAGSEGURO_TOKEN=your_pagseguro_token
+
+# -------------------------------------------
+# API Keys (generated via CLI)
+# -------------------------------------------
+API_PUBLIC_KEY=your_api_public_key_here
+API_SECRET_KEY=your_api_secret_key_here
+
+# -------------------------------------------
+# Optional / Development Settings
+# -------------------------------------------
+APP_TIMEZONE=America/Sao_Paulo
+
+# -------------------------------------------
+# PHP Configuration (INI overrides)
+# -------------------------------------------
+PHP_MEMORY_LIMIT=1024M
+PHP_MAX_EXECUTION_TIME=300
+PHP_MAX_INPUT_TIME=120
+PHP_UPLOAD_MAX_FILESIZE=256M
+PHP_POST_MAX_SIZE=256M
+PHP_MAX_FILE_UPLOADS=50
+PHP_DISPLAY_ERRORS=true
+PHP_DISPLAY_STARTUP_ERRORS=true
+PHP_ERROR_REPORTING=E_ALL
+PHP_LOG_ERRORS=true
+PHP_ERROR_LOG=/var/log/php_errors.log
+
+# -------------------------------------------
+# AI / LLM Provider Settings (optional)
+# -------------------------------------------
+OPENROUTER_API_KEY=your_openrouter_api_key_here
+OPENROUTER_MODEL=
+
+STEPFUN_BASE_URL=https://api.stepfun.ai/step_plan/v1/
+STEPFUN_API_KEY=your_stepfun_api_key_here
+STEPFUN_MODEL=
+
+LLAMACPP_BASE_URL=http://localhost:8080/v1/
+LLAMACPP_API_KEY=not-needed
+LLAMACPP_MODEL=
+
+# -------------------------------------------
+# Telegram Bot (optional)
+# -------------------------------------------
+TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here
+TELEGRAM_WEBHOOK_URL=
+TELEGRAM_CHAT_ID=
+
+# -------------------------------------------
+# Storage Paths
+# -------------------------------------------
+UPLOADS_DIR=/path/to/sysmvc/public/uploads