create-fluxstack 1.7.5 → 1.8.3

package/.dockerignore

@@ -0,0 +1,82 @@
+# =====================================
+# FluxStack Docker Ignore
+# =====================================
+
+# Node modules (will be installed in container)
+node_modules/
+**/node_modules/
+
+# Build artifacts (will be built in container)
+dist/
+**/dist/
+
+# Development files
+.git/
+.github/
+.vscode/
+.idea/
+
+# Environment files
+.env
+.env.*
+!.env.example
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+bun-debug.log*
+lerna-debug.log*
+
+# Testing
+coverage/
+.nyc_output/
+**/__tests__/
+**/*.test.ts
+**/*.test.tsx
+**/*.spec.ts
+**/*.spec.tsx
+
+# Documentation
+*.md
+!README.md
+ai-context/
+docs/
+
+# Development tools
+.eslintrc*
+.prettierrc*
+tsconfig*.json
+vitest.config.ts
+vite.config.ts
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+*.swp
+*.swo
+*~
+
+# Lock files (exclude other package managers, keep bun.lock)
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# CI/CD
+.github/
+
+# Editor directories
+.vscode/
+.idea/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

package/.env.example

@@ -28,6 +28,25 @@ CORS_HEADERS=Content-Type,Authorization
 # Logging
 LOG_LEVEL=info
 
+# Swagger Documentation
+SWAGGER_ENABLED=true
+SWAGGER_TITLE=FluxStack API
+SWAGGER_VERSION=1.8.2
+SWAGGER_DESCRIPTION=API documentation for FluxStack application
+SWAGGER_PATH=/swagger
+# SWAGGER_EXCLUDE_PATHS=/internal,/admin
+# SWAGGER_SERVERS=https://api.myapp.com|Production,https://staging.myapp.com|Staging
+SWAGGER_PERSIST_AUTH=true
+SWAGGER_DISPLAY_DURATION=true
+SWAGGER_ENABLE_FILTER=true
+SWAGGER_SHOW_EXTENSIONS=true
+SWAGGER_TRY_IT_OUT=true
+
+# Swagger Authentication (Basic Auth)
+SWAGGER_AUTH_ENABLED=false
+SWAGGER_AUTH_USERNAME=admin
+# SWAGGER_AUTH_PASSWORD=your-secure-password-here
+
 # Build Configuration
 BUILD_TARGET=bun
 BUILD_OUTDIR=dist

package/Dockerfile

@@ -0,0 +1,70 @@
+# 🐳 FluxStack Production Dockerfile
+# Multi-stage build for optimized production image
+
+# =====================================
+# Stage 1: Dependencies
+# =====================================
+FROM oven/bun:1.1.34-alpine AS deps
+
+WORKDIR /app
+
+# Copy package files
+COPY package.json bun.lock ./
+
+# Install production dependencies only
+RUN bun install --production --frozen-lockfile
+
+# =====================================
+# Stage 2: Builder
+# =====================================
+FROM oven/bun:1.1.34-alpine AS builder
+
+WORKDIR /app
+
+# Copy package files and install all dependencies (including dev)
+COPY package.json bun.lock ./
+RUN bun install --frozen-lockfile
+
+# Copy source code
+COPY . .
+
+# Build the application
+RUN bun run build
+
+# =====================================
+# Stage 3: Production Runner
+# =====================================
+FROM oven/bun:1.1.34-alpine AS runner
+
+WORKDIR /app
+
+# Set production environment
+ENV NODE_ENV=production
+ENV PORT=3000
+
+# Create non-root user for security
+RUN addgroup -g 1001 -S fluxstack && \
+    adduser -S fluxstack -u 1001
+
+# Copy production dependencies from deps stage
+COPY --from=deps --chown=fluxstack:fluxstack /app/node_modules ./node_modules
+
+# Copy built application from builder stage
+COPY --from=builder --chown=fluxstack:fluxstack /app/dist ./dist
+COPY --from=builder --chown=fluxstack:fluxstack /app/package.json ./
+
+# Copy config directory (required for runtime configuration)
+COPY --from=builder --chown=fluxstack:fluxstack /app/config ./config
+
+# Switch to non-root user
+USER fluxstack
+
+# Expose application port
+EXPOSE 3000
+
+# Health check disabled for now
+# HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
+#   CMD bun run -e 'fetch("http://localhost:3000/api/health").then(r => r.ok ? process.exit(0) : process.exit(1))' || exit 1
+
+# Start the application
+CMD ["bun", "run", "start"]

package/README.md

@@ -10,12 +10,15 @@ Create modern full-stack TypeScript applications with zero configuration.
 ## Quick Start
 
 ```bash
-# scaffold a new FluxStack app
+# Create a new FluxStack app
 bunx create-fluxstack my-awesome-app
-
-# enter the project and start developing
 cd my-awesome-app
 bun run dev
+
+# OR create in current directory
+mkdir my-app && cd my-app
+bunx create-fluxstack .
+bun run dev
 ```
 
 Your development environment will be available at:

package/app/client/SIMPLIFICATION.md

@@ -0,0 +1,140 @@
+# 🎨 FluxStack Client - Simplified Version
+
+This is a **simplified, single-page version** of the FluxStack client, inspired by the clean and modern design of Vite's landing page.
+
+## 🚀 What Changed?
+
+### ✅ **Kept (Essential)**
+- ✅ **Eden Treaty** - Core type-safe API client
+- ✅ **React 19** - Modern React with hooks
+- ✅ **Vite 7** - Lightning-fast dev server
+- ✅ **TailwindCSS** - Utility-first styling
+- ✅ **TypeScript** - Full type safety
+- ✅ **react-icons** - Icon library
+
+### ❌ **Removed (Complexity)**
+- ❌ **React Router** - No more multi-page routing
+- ❌ **Zustand** - Removed complex state management (using simple `useState`)
+- ❌ **Multiple Pages** - Consolidated into single page (Overview, Demo, HybridLive, ApiDocs, CryptoAuth)
+- ❌ **Complex Error System** - Simplified error handling
+- ❌ **Navigation System** - No more tabs and complex navigation
+- ❌ **Detailed API Status Section** - Replaced with simple badge
+- ❌ **Complex Live Component UIs** - Simplified to minimal clock display
+
+### ✅ **Kept (Advanced Features)**
+- ✅ **LiveComponents** - Live Clock provido via LiveComponent
+- ✅ **LiveComponentsProvider** - Full real-time capabilities maintained
+- ✅ **Hybrid Live Component** - Clock synced with server in real-time
+
+## 📊 Comparison
+
+| Metric | Before | After | Reduction |
+|--------|--------|-------|-----------|
+| **Files** | 43 | ~10 | **-76%** |
+| **Components** | 11 | 2 | **-82%** |
+| **Pages** | 5 | 1 | **-80%** |
+| **Dependencies** | 27 | 19 | **-30%** |
+| **Lines in App.tsx** | 331 | 213 | **-36%** |
+| **Live Components** | 6 complex | 1 minimal | **-83%** |
+
+## 🎯 What Does It Show?
+
+The simplified client demonstrates:
+
+1. **🎨 Minimalist Design** - Clean, centered design inspired by Next.js, React, and Vite
+2. **⚡ Simple API Status** - Single badge showing API online/offline
+3. **🚀 Core Features** - 4 feature cards highlighting main capabilities
+4. **🕐 Live Clock** - Real LiveComponent synced with server in real-time
+5. **📖 Quick Actions** - Direct links to API Docs, GitHub, and API Demo
+6. **🔥 Clean but Powerful** - Minimalist UI with full real-time capabilities
+
+## 📝 Structure
+
+```
+app/client/src/
+├── App.tsx              # Single-page application (213 lines)
+│                        # - AppContent component (main UI)
+│                        # - MinimalLiveClock component (LiveComponent)
+│                        # - LiveComponentsProvider wrapper
+├── main.tsx             # Entry point (simplified)
+├── index.css            # Minimal global styles
+├── vite-env.d.ts        # Vite type definitions
+├── assets/              # Static assets
+│   └── react.svg        # React logo
+└── lib/                 # Core utilities
+    ├── eden-api.ts      # Eden Treaty API client
+    └── errors.ts        # Error handling utilities
+```
+
+**Total files in src/**: 6 core files (vs 43+ before)
+
+## 🎨 Design Philosophy
+
+Inspired by **Next.js, React, and Vite landing pages**:
+- Everything centered vertically and horizontally
+- Large animated logo (fire icon with pulse animation)
+- Minimal text, maximum impact
+- Simple API status badge (online/offline)
+- 4 feature cards in responsive grid
+- **Live Clock via LiveComponent** - Real-time sync with server
+- Clean action buttons at bottom
+- No background blob animations (clean and fast)
+- Mobile-first responsive design
+- **Full Live Components support** - Maintains advanced real-time features
+
+## 🔧 How to Use
+
+```bash
+# Start development server (backend + frontend)
+bun run dev
+
+# Frontend only
+bun run dev:frontend
+
+# Backend only
+bun run dev:backend
+```
+
+The page will automatically show:
+- ✅ **Green badge** - Backend is running and healthy
+- ⚠️ **Yellow badge** - Checking backend status
+- ❌ **Red badge** - Backend is offline
+
+## 🎯 When to Use This Version?
+
+**Use this ultra-simplified version when:**
+- You want the cleanest possible presentation
+- You're showcasing FluxStack to newcomers or investors
+- You need a professional landing page
+- You want maximum simplicity (like Next.js/React/Vite)
+- You prefer minimalism over features
+- You want fast loading and minimal JavaScript
+
+**Use the full version when:**
+- You need multiple pages/routes
+- You require complex state management
+- You want real-time features (WebSocket)
+- You need complete demos (CRUD, Auth, etc.)
+- You're building a full application with all features
+
+## 💡 Future Enhancements (Optional)
+
+If you want to extend this simplified version, consider adding:
+- [ ] Simple counter demo using Eden Treaty
+- [ ] User CRUD with minimal UI
+- [ ] Dark/Light theme toggle
+- [ ] Smooth scroll to sections
+- [ ] More feature cards
+
+## 📚 References
+
+- [FluxStack Documentation](../../ai-context/)
+- [Eden Treaty Guide](../../ai-context/development/eden-treaty-guide.md)
+- [Vite Documentation](https://vite.dev)
+- [React Documentation](https://react.dev)
+
+---
+
+**🎯 Goal**: Provide a clean, simple, and beautiful client that showcases FluxStack's core value proposition without overwhelming complexity.
+
+**Made with ❤️ by FluxStack Team**

package/app/client/frontend-only.ts

@@ -1,5 +1,5 @@
 // Frontend standalone entry point
-import { startFrontendOnly } from "../../core/client/standalone"
+import { startFrontendOnly } from "@/core/client/standalone"
 
 // Configuração para frontend standalone
 const frontendConfig = {