create-fluxstack 1.0.1 → 1.0.3

package/ai-context/reference/troubleshooting.md

@@ -0,0 +1,407 @@
+# 🚨 Troubleshooting - FluxStack
+
+> **Guia completo para resolver problemas comuns no FluxStack**
+
+## ⚡ **Diagnóstico Rápido**
+
+### **🔍 Comandos de Diagnóstico**
+```bash
+# 1. Verificar APIs
+curl http://localhost:3000/api/health
+curl http://localhost:3000/swagger/json
+
+# 2. Verificar TypeScript
+bunx tsc --noEmit
+
+# 3. Verificar testes
+bun run test
+
+# 4. Verificar build
+bun run build
+```
+
+### **🌐 URLs Importantes**
+- **Backend**: http://localhost:3000
+- **Frontend**: http://localhost:5173  
+- **Swagger**: http://localhost:3000/swagger
+- **Health**: http://localhost:3000/api/health
+
+## 🔧 **Problemas de Desenvolvimento**
+
+### **❌ Erro: "Cannot find module 'vite/module-runner'"**
+```bash
+# Problema: Vite sendo importado em produção
+# Solução: Verificar env vars e plugins
+export NODE_ENV=development
+bun run dev
+```
+
+### **❌ Types `unknown` no Eden Treaty**
+```typescript
+// ❌ Problema
+const { data, error } = await api.users.get()
+// data é 'unknown' em vez de { users: User[] }
+
+// ✅ Solução: Verificar response schemas
+export const usersRoutes = new Elysia()
+  .get("/", handler, {
+    response: t.Object({
+      users: t.Array(t.Object({
+        id: t.Number(),
+        name: t.String(),
+        email: t.String()
+      }))
+    })
+  })
+```
+
+### **❌ Hot Reload Não Funciona**
+```bash
+# Verificar se Vite já está rodando
+lsof -i :5173  # Mac/Linux
+netstat -ano | findstr :5173  # Windows
+
+# Matar processo se necessário
+pkill -f vite  # Mac/Linux
+taskkill /F /IM node.exe  # Windows
+
+# Reiniciar
+bun run dev
+```
+
+### **❌ Erro de Porta em Uso**
+```bash
+# Verificar processos na porta
+lsof -i :3000  # Backend
+lsof -i :5173  # Frontend
+
+# Matar processo
+kill -9 <PID>
+
+# Ou usar porta diferente
+PORT=3001 bun run dev
+```
+
+### **❌ TypeScript Errors Massivos**
+```bash
+# 1. Limpar cache
+rm -rf node_modules/.cache
+rm -rf dist/
+
+# 2. Reinstalar
+bun install
+
+# 3. Verificar versões
+bunx tsc --version
+bun --version
+
+# 4. Restart TypeScript server (VS Code)
+Ctrl+Shift+P → "TypeScript: Restart TS Server"
+```
+
+## 🌐 **Problemas de API**
+
+### **❌ CORS Errors**
+```javascript
+// ❌ Error: CORS policy blocks request
+// ✅ Normal: API (3000) ≠ Frontend (5173)
+
+// Verificar se API está respondendo
+fetch('http://localhost:3000/api/health')
+  .then(r => r.json())
+  .then(console.log)
+
+// Eden Treaty deveria lidar automaticamente
+```
+
+### **❌ 404 Not Found nas Rotas**
+```typescript
+// ❌ Problema: Rota não encontrada
+// ✅ Verificar prefix e estrutura
+
+// 1. Verificar export das rotas
+export const apiRoutes = new Elysia({ prefix: "/api" })
+  .use(usersRoutes)  // ← Rota precisa estar registrada
+
+// 2. Verificar URL final
+// users routes com prefix "/users" 
+// apiRoutes com prefix "/api"
+// URL final: /api/users
+```
+
+### **❌ Validation Errors**
+```typescript
+// ❌ Body validation failed
+// ✅ Verificar schema da rota
+
+.post("/", handler, {
+  body: t.Object({
+    name: t.String({ minLength: 2 }),  // ← Verificar requisitos
+    email: t.String({ format: "email" })
+  })
+})
+
+// Client request deve corresponder:
+await api.users.post({
+  name: "João",      // ← String com 2+ chars
+  email: "joao@x.com" // ← Email válido
+})
+```
+
+### **❌ Error Handling Não Funciona**
+```typescript
+// ❌ Problema: Errors não tratados
+const { data, error } = await api.users.get()
+
+// ✅ Sempre verificar error primeiro
+if (error) {
+  console.log(`API Error: ${error.status} - ${error.message}`)
+  return
+}
+
+// Agora data é garantidamente válido
+console.log(data.users)
+```
+
+## ⚛️ **Problemas de Frontend**
+
+### **❌ React Hook Warnings**
+```typescript
+// ❌ Warning: Can't perform state update on unmounted component
+
+// ✅ Solução: Cleanup no useEffect
+useEffect(() => {
+  let mounted = true
+  
+  const loadData = async () => {
+    const { data, error } = await api.users.get()
+    if (mounted && !error) {
+      setUsers(data.users)
+    }
+  }
+  
+  loadData()
+  
+  return () => { mounted = false }  // ← Cleanup
+}, [])
+```
+
+### **❌ State Updates Não Refletem**
+```typescript
+// ❌ Problema: State não atualiza após API call
+
+// ✅ Verificar se setState está sendo chamado
+const createUser = async (userData) => {
+  const { data, error } = await api.users.post(userData)
+  
+  if (!error && data.success) {
+    setUsers(prev => [...prev, data.user])  // ← Crucial!
+  }
+}
+```
+
+### **❌ Infinite Re-renders**
+```typescript
+// ❌ Problema: useEffect sem dependencies
+useEffect(() => {
+  loadUsers()  // ← Vai chamar infinitamente
+})
+
+// ✅ Solução: Dependencies corretas
+useEffect(() => {
+  loadUsers()
+}, [])  // ← Empty array = run once
+
+// ✅ Ou use useCallback
+const loadUsers = useCallback(async () => {
+  // ...
+}, [])
+
+useEffect(() => {
+  loadUsers()
+}, [loadUsers])
+```
+
+## 🏗️ **Problemas de Build**
+
+### **❌ Build Failures**
+```bash
+# 1. Verificar imports
+# ❌ Problema comum
+import { api } from '../../lib/eden-api'  # Path relativo
+import type { User } from '../../../shared/types'  # Muitos ../
+
+# ✅ Usar path aliases (tsconfig.json)
+import { api } from '@/lib/eden-api'
+import type { User } from '@/shared/types'
+
+# 2. Verificar exports
+# Cada arquivo deve ter export padrão ou nomeado correto
+```
+
+### **❌ Type Errors na Build**
+```typescript
+// ❌ Problema: Tipos diferentes dev vs build
+// ✅ Verificar tsconfig.json consistency
+
+{
+  "compilerOptions": {
+    "strict": true,
+    "skipLibCheck": false,  // ← Importante para libs
+    "moduleResolution": "bundler"
+  }
+}
+```
+
+### **❌ Asset Loading Problems**
+```typescript
+// ❌ Problema: Assets não carregam em prod
+// ✅ Usar public/ folder
+
+// ❌ Errado
+import logo from '../assets/logo.png'
+
+// ✅ Correto  
+<img src="/logo.png" />  // File em public/logo.png
+```
+
+## 🐳 **Problemas de Docker**
+
+### **❌ Docker Build Falha**
+```dockerfile
+# ❌ Problema: Node modules não copiados
+# ✅ Verificar .dockerignore
+
+# .dockerignore não deve incluir:
+# node_modules/  ← OK, será reinstalado
+# dist/          ← OK, será gerado
+# .env           ← Cuidado: env vars podem ser necessárias
+```
+
+### **❌ Container Não Inicia**
+```bash
+# Verificar logs
+docker logs <container-id>
+
+# Verificar portas
+docker ps
+docker port <container-id>
+
+# Verificar conectividade
+curl http://localhost:3000/api/health
+```
+
+## 🧪 **Problemas de Testing**
+
+### **❌ Tests Falhando**
+```typescript
+// ❌ Problema: API calls em tests
+// ✅ Mock Eden Treaty
+
+// tests/setup.ts
+vi.mock('@/lib/eden-api', () => ({
+  api: {
+    users: {
+      get: vi.fn(),
+      post: vi.fn()
+    }
+  }
+}))
+
+// test.ts
+import { api } from '@/lib/eden-api'
+
+it('should handle users', () => {
+  const mockUsers = [{ id: 1, name: 'Test' }]
+  vi.mocked(api.users.get).mockResolvedValue({
+    data: { users: mockUsers },
+    error: undefined
+  })
+  
+  // Test component...
+})
+```
+
+### **❌ Mock Not Working**
+```typescript
+// ❌ Problema: Mocks não aplicados
+// ✅ Verificar ordem de imports
+
+// ❌ Errado
+import { Component } from './Component'
+import { vi } from 'vitest'
+
+// ✅ Correto
+import { vi } from 'vitest'
+vi.mock('./api')
+import { Component } from './Component'
+```
+
+## 🔧 **Ferramentas de Debug**
+
+### **✅ Browser DevTools**
+```javascript
+// Network tab
+// - Verificar requests/responses
+// - Status codes
+// - Headers CORS
+
+// Console
+// - Eden Treaty debug
+console.log('API call:', await api.users.get())
+
+// React DevTools  
+// - Component state
+// - Props debugging
+// - Hook values
+```
+
+### **✅ Bun Debugging**
+```bash
+# Debug mode
+DEBUG=* bun run dev
+
+# Verbose output
+bun run dev --verbose
+
+# Memory usage
+bun run --inspect dev
+```
+
+### **✅ Elysia Debugging**
+```typescript
+// app/server/index.ts
+app.onError((error) => {
+  console.error('Elysia Error:', error)
+  return { error: error.message, status: 500 }
+})
+
+app.onRequest((request) => {
+  console.log(`${request.method} ${request.url}`)
+})
+
+app.onResponse((response) => {
+  console.log(`Response: ${response.status}`)
+})
+```
+
+## 📋 **Checklist de Troubleshooting**
+
+### **🔍 Quando algo não funciona:**
+1. **Verificar URLs** - APIs nas portas certas?
+2. **Verificar types** - `bunx tsc --noEmit`
+3. **Verificar console** - Errors no browser/terminal?
+4. **Verificar schemas** - Response schemas definidos?
+5. **Verificar imports** - Paths corretos?
+6. **Reiniciar tudo** - `bun run dev` fresh
+
+### **🆘 Quando tudo falha:**
+1. **Clean install**: `rm -rf node_modules && bun install`
+2. **Clear cache**: `rm -rf dist/ .cache/`
+3. **Restart editor**: Recarregar VS Code
+4. **Check docs**: Verificar esta documentação
+5. **Minimal repro**: Isolar o problema
+
+---
+
+**🎯 90% dos problemas são resolvidos verificando response schemas, imports corretos e reiniciando o dev server!**

package/bun.lock

@@ -8,14 +8,14 @@
         "@elysiajs/swagger": "^1.3.1",
         "@types/http-proxy-middleware": "^1.0.0",
         "@vitejs/plugin-react": "^4.6.0",
-        "chalk": "^5.6.2",
+        "chalk": "^5.3.0",
         "chokidar": "^4.0.3",
-        "commander": "^14.0.1",
+        "commander": "^12.1.0",
         "elysia": "^1.4.6",
         "http-proxy-middleware": "^3.0.5",
         "lightningcss": "^1.30.1",
         "lucide-react": "^0.544.0",
-        "ora": "^9.0.0",
+        "ora": "^8.1.0",
         "react": "^19.1.0",
         "react-dom": "^19.1.0",
         "vite": "^7.0.4",
@@ -430,7 +430,7 @@
 
     "cli-cursor": ["cli-cursor@5.0.0", "", { "dependencies": { "restore-cursor": "^5.0.0" } }, "sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw=="],
 
-    "cli-spinners": ["cli-spinners@3.2.1", "", {}, "sha512-Xh+cRh7dzk9n7gYE+M1Lusy3yg5ADy9m6zOHqmcu9kSkWpo7ySWVUS3dXleR3konJOEOdHzsKjWkGed6g2eJuA=="],
+    "cli-spinners": ["cli-spinners@2.9.2", "", {}, "sha512-ywqV+5MmyL4E7ybXgKys4DugZbX0FC6LnwrhjuykIjnK9k8OQacQ7axGKnjDXWNhns0xot3bZI5h55H8yo9cJg=="],
 
     "cliui": ["cliui@8.0.1", "", { "dependencies": { "string-width": "^4.2.0", "strip-ansi": "^6.0.1", "wrap-ansi": "^7.0.0" } }, "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ=="],
 
@@ -438,7 +438,7 @@
 
     "color-name": ["color-name@1.1.4", "", {}, "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="],
 
-    "commander": ["commander@14.0.1", "", {}, "sha512-2JkV3gUZUVrbNA+1sjBOYLsMZ5cEEl8GTFP2a4AVz5hvasAMCQ1D2l2le/cX+pV4N6ZU17zjUahLpIXRrnWL8A=="],
+    "commander": ["commander@12.1.0", "", {}, "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA=="],
 
     "concat-map": ["concat-map@0.0.1", "", {}, "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg=="],
 
@@ -478,7 +478,7 @@
 
     "elysia": ["elysia@1.4.6", "", { "dependencies": { "cookie": "^1.0.2", "exact-mirror": "0.2.2", "fast-decode-uri-component": "^1.0.1" }, "optionalDependencies": { "@sinclair/typebox": ">= 0.34.0 < 1", "openapi-types": ">= 12.0.0" }, "peerDependencies": { "file-type": ">= 20.0.0", "typescript": ">= 5.0.0" } }, "sha512-u2CorXLPs5ZXyWP+tQR+bgka/lJA4vNpB8lDE2w/sTmdaIwoPQmHEL4J3ai6OAlluWR1kfG7T9gO3EYT9D8viQ=="],
 
-    "emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
+    "emoji-regex": ["emoji-regex@10.5.0", "", {}, "sha512-lb49vf1Xzfx080OKA0o6l8DQQpV+6Vg95zyCJX9VB/BqKYlhG7N4wgROUUHRA+ZPUefLnteQOad7z1kT2bV7bg=="],
 
     "enhanced-resolve": ["enhanced-resolve@5.18.3", "", { "dependencies": { "graceful-fs": "^4.2.4", "tapable": "^2.2.0" } }, "sha512-d4lC8xfavMeBjzGr2vECC3fsGXziXZQyJxD868h2M/mBI3PwAuODxAkLkq5HYuvrPYcUtiLzsTo8U3PgX3Ocww=="],
 
@@ -674,7 +674,7 @@
 
     "lodash.merge": ["lodash.merge@4.6.2", "", {}, "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ=="],
 
-    "log-symbols": ["log-symbols@7.0.1", "", { "dependencies": { "is-unicode-supported": "^2.0.0", "yoctocolors": "^2.1.1" } }, "sha512-ja1E3yCr9i/0hmBVaM0bfwDjnGy8I/s6PP4DFp+yP+a+mrHO4Rm7DtmnqROTUkHIkqffC84YY7AeqX6oFk0WFg=="],
+    "log-symbols": ["log-symbols@6.0.0", "", { "dependencies": { "chalk": "^5.3.0", "is-unicode-supported": "^1.3.0" } }, "sha512-i24m8rpwhmPIS4zscNzK6MSEhk0DUWa/8iYQWxhffV8jkI4Phvs3F+quL5xvS0gdQR0FyTCMMH33Y78dDTzzIw=="],
 
     "loupe": ["loupe@3.2.1", "", {}, "sha512-CdzqowRJCeLU72bHvWqwRBBlLcMEtIvGrlvef74kMnV2AolS9Y8xUv1I0U/MNAWMhBlKIoyuEgoJ0t/bbwHbLQ=="],
 
@@ -724,7 +724,7 @@
 
     "optionator": ["optionator@0.9.4", "", { "dependencies": { "deep-is": "^0.1.3", "fast-levenshtein": "^2.0.6", "levn": "^0.4.1", "prelude-ls": "^1.2.1", "type-check": "^0.4.0", "word-wrap": "^1.2.5" } }, "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g=="],
 
-    "ora": ["ora@9.0.0", "", { "dependencies": { "chalk": "^5.6.2", "cli-cursor": "^5.0.0", "cli-spinners": "^3.2.0", "is-interactive": "^2.0.0", "is-unicode-supported": "^2.1.0", "log-symbols": "^7.0.1", "stdin-discarder": "^0.2.2", "string-width": "^8.1.0", "strip-ansi": "^7.1.2" } }, "sha512-m0pg2zscbYgWbqRR6ABga5c3sZdEon7bSgjnlXC64kxtxLOyjRcbbUkLj7HFyy/FTD+P2xdBWu8snGhYI0jc4A=="],
+    "ora": ["ora@8.2.0", "", { "dependencies": { "chalk": "^5.3.0", "cli-cursor": "^5.0.0", "cli-spinners": "^2.9.2", "is-interactive": "^2.0.0", "is-unicode-supported": "^2.0.0", "log-symbols": "^6.0.0", "stdin-discarder": "^0.2.2", "string-width": "^7.2.0", "strip-ansi": "^7.1.0" } }, "sha512-weP+BZ8MVNnlCm8c0Qdc1WSWq4Qn7I+9CJGm7Qali6g44e/PUzbjNqJX5NJ9ljlNMosfJvg1fKEGILklK9cwnw=="],
 
     "p-limit": ["p-limit@3.1.0", "", { "dependencies": { "yocto-queue": "^0.1.0" } }, "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ=="],
 
@@ -818,7 +818,7 @@
 
     "stdin-discarder": ["stdin-discarder@0.2.2", "", {}, "sha512-UhDfHmA92YAlNnCfhmq0VeNL5bDbiZGg7sZ2IvPsXubGkiNa9EC+tUTsjBRsYUAz87btI6/1wf4XoVvQ3uRnmQ=="],
 
-    "string-width": ["string-width@8.1.0", "", { "dependencies": { "get-east-asian-width": "^1.3.0", "strip-ansi": "^7.1.0" } }, "sha512-Kxl3KJGb/gxkaUMOjRsQ8IrXiGW75O4E3RPjFIINOVH8AMl2SQ/yWdTzWwF3FevIX9LcMAjJW+GRwAlAbTSXdg=="],
+    "string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
 
     "string-width-cjs": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
 
@@ -936,8 +936,6 @@
 
     "yocto-queue": ["yocto-queue@0.1.0", "", {}, "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q=="],
 
-    "yoctocolors": ["yoctocolors@2.1.2", "", {}, "sha512-CzhO+pFNo8ajLM2d2IW/R93ipy99LWjtwblvC1RsoSUMZgyLbYFr221TnSNT7GjGdYui6P459mw9JH/g/zW2ug=="],
-
     "zhead": ["zhead@2.2.4", "", {}, "sha512-8F0OI5dpWIA5IGG5NHUg9staDwz/ZPxZtvGVf01j7vHqSyZ0raHY+78atOVxRqb73AotX22uV1pXt3gYSstGag=="],
 
     "zod": ["zod@3.25.76", "", {}, "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ=="],
@@ -996,12 +994,16 @@
 
     "istanbul-lib-report/supports-color": ["supports-color@7.2.0", "", { "dependencies": { "has-flag": "^4.0.0" } }, "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw=="],
 
+    "log-symbols/is-unicode-supported": ["is-unicode-supported@1.3.0", "", {}, "sha512-43r2mRvz+8JRIKnWJ+3j8JtjRKZ6GmjzfaE/qiBJnikNnYv/6bagRJ1kUhNk8R5EX/GkobD+r+sfxCPJsiKBLQ=="],
+
     "micromatch/picomatch": ["picomatch@2.3.1", "", {}, "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA=="],
 
     "pretty-format/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
 
     "pretty-format/ansi-styles": ["ansi-styles@5.2.0", "", {}, "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA=="],
 
+    "string-width-cjs/emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
+
     "string-width-cjs/strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
 
     "strip-ansi-cjs/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
@@ -1030,6 +1032,8 @@
 
     "@typescript-eslint/typescript-estree/minimatch/brace-expansion": ["brace-expansion@2.0.2", "", { "dependencies": { "balanced-match": "^1.0.0" } }, "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ=="],
 
+    "cliui/string-width/emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
+
     "cliui/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
 
     "concurrently/chalk/supports-color": ["supports-color@7.2.0", "", { "dependencies": { "has-flag": "^4.0.0" } }, "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw=="],
@@ -1042,10 +1046,16 @@
 
     "test-exclude/minimatch/brace-expansion": ["brace-expansion@2.0.2", "", { "dependencies": { "balanced-match": "^1.0.0" } }, "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ=="],
 
+    "wrap-ansi-cjs/string-width/emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
+
     "wrap-ansi-cjs/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
 
+    "wrap-ansi/string-width/emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
+
     "wrap-ansi/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
 
+    "yargs/string-width/emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
+
     "yargs/string-width/strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
 
     "yargs/string-width/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],

package/bunfig.toml

@@ -0,0 +1,16 @@
+# FluxStack Bun Configuration
+[build]
+target = "bun"
+
+[install]
+# Package installation settings
+cache = true
+lockfile = true
+
+# Path mapping (alias support)
+[build.alias]
+"@" = "."
+"@/core" = "./core"
+"@/app" = "./app"
+"@/config" = "./config"
+"@/shared" = "./app/shared"

package/config/fluxstack.config.ts

@@ -0,0 +1,48 @@
+/**
+ * Backward Compatibility Layer for FluxStack Configuration
+ * This file maintains compatibility with existing imports while redirecting to the new system
+ * @deprecated Use the configuration from the root fluxstack.config.ts instead
+ */
+
+import { getConfigSync, createLegacyConfig } from '../core/config'
+import type { FluxStackConfig } from '../core/config'
+
+// Load the new configuration
+const newConfig = getConfigSync()
+
+// Create legacy configuration format for backward compatibility
+const legacyConfig = createLegacyConfig(newConfig)
+
+// Export in the old format
+export const config = legacyConfig
+
+// Also export the environment config for backward compatibility
+export const envConfig = {
+  NODE_ENV: process.env.NODE_ENV || 'development',
+  HOST: newConfig.server.host,
+  PORT: newConfig.server.port,
+  FRONTEND_PORT: newConfig.client.port,
+  BACKEND_PORT: newConfig.server.port,
+  VITE_API_URL: newConfig.client.proxy.target,
+  API_URL: newConfig.client.proxy.target,
+  CORS_ORIGINS: newConfig.server.cors.origins,
+  CORS_METHODS: newConfig.server.cors.methods,
+  CORS_HEADERS: newConfig.server.cors.headers,
+  LOG_LEVEL: newConfig.logging.level,
+  BUILD_TARGET: newConfig.build.target,
+  BUILD_OUTDIR: newConfig.build.outDir,
+  // Add other legacy environment variables as needed
+}
+
+// Warn about deprecated usage in development
+if (process.env.NODE_ENV === 'development') {
+  console.warn(
+    '⚠️  DEPRECATED: Importing from config/fluxstack.config.ts is deprecated.\n' +
+    '   Please update your imports to use the new configuration system:\n' +
+    '   import { getConfig } from "./core/config"\n' +
+    '   or import config from "./fluxstack.config.ts"'
+  )
+}
+
+// Export types for backward compatibility
+export type { FluxStackConfig }

package/create-fluxstack.ts

@@ -53,11 +53,10 @@ program
       mkdirSync(projectPath, { recursive: true })
       
       // Copy only essential FluxStack files (not node_modules, not test apps, etc.)
+      const frameworkDir = currentDir // Use current directory (framework root)
       const filesToCopy = [
         'core',
         'app',
-        'package.json',
-        'package-template.json', // ✅ Template for project package.json
         'bun.lock',  // ✅ CRITICAL: Copy lockfile to maintain working versions
         'tsconfig.json',
         'vite.config.ts',
@@ -66,7 +65,7 @@ program
       ]
       
       for (const file of filesToCopy) {
-        const sourcePath = join(currentDir, file)
+        const sourcePath = join(frameworkDir, file)
         const destPath = join(projectPath, file)
         
         if (existsSync(sourcePath)) {