create-fluxstack 1.0.0

package/.env

@@ -0,0 +1,30 @@
+# FluxStack Environment Variables
+
+# Development Mode
+#NODE_ENV=development
+NODE_ENV=production
+# Server Configuration
+PORT=3000
+HOST=localhost
+
+# Frontend Configuration
+FRONTEND_PORT=5173
+VITE_API_URL=http://localhost:3000
+VITE_APP_NAME=FluxStack
+VITE_APP_VERSION=1.4.0
+VITE_NODE_ENV=development
+
+# Backend Configuration
+BACKEND_PORT=3001
+
+# CORS Configuration
+CORS_ORIGINS=http://localhost:3000,http://localhost:5173
+CORS_METHODS=GET,POST,PUT,DELETE,OPTIONS
+CORS_HEADERS=Content-Type,Authorization
+
+# Logging
+LOG_LEVEL=info
+
+# Build Configuration
+BUILD_TARGET=bun
+BUILD_OUTDIR=dist

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Marcos Brendon De Paula
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,214 @@
+# ⚡ create-fluxstack
+
+> Create FluxStack apps with zero configuration - powered by Bun
+
+[![npm version](https://badge.fury.io/js/create-fluxstack.svg)](https://badge.fury.io/js/create-fluxstack)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 🚀 Quick Start
+
+```bash
+# Create a new FluxStack app
+bunx create-fluxstack my-awesome-app
+
+# Or with npx
+npx create-fluxstack my-awesome-app
+
+# Navigate and start developing
+cd my-awesome-app
+bun run dev
+```
+
+**That's it!** Your full-stack TypeScript app is ready at:
+- **Backend**: http://localhost:3000
+- **Frontend**: http://localhost:5173
+- **API Docs**: http://localhost:3000/swagger
+
+## ✨ What You Get
+
+### 🔥 Modern Tech Stack
+- **⚡ Bun Runtime** - 3x faster than Node.js
+- **🚀 Elysia.js** - Ultra-fast backend framework
+- **⚛️ React 19** - Latest React with modern features
+- **🎨 Tailwind CSS v4** - Latest styling framework
+- **📦 Vite 7** - Lightning-fast dev server
+- **🔒 TypeScript 5** - Full type safety end-to-end
+
+### 🛠️ Zero Configuration
+- **✅ Hot Reload** - Backend + Frontend coordinated
+- **✅ Type Safety** - Eden Treaty for API communication
+- **✅ Auto Documentation** - Swagger UI generated
+- **✅ Git Ready** - Initialized with first commit
+- **✅ Production Ready** - Build scripts included
+
+## 📁 Project Structure
+
+```
+my-awesome-app/
+├── core/          # FluxStack framework (don't modify)
+├── app/           # Your application code
+│   ├── server/    # Backend API routes
+│   ├── client/    # Frontend React app
+│   └── shared/    # Shared types and utilities
+├── package.json   # Dependencies and scripts
+└── README.md      # Project documentation
+```
+
+## 🎯 Available Scripts
+
+```bash
+# Development
+bun run dev              # Start full-stack development
+bun run dev:frontend     # Frontend only
+bun run dev:backend      # Backend only
+
+# Production
+bun run build            # Build for production
+bun run start            # Start production server
+
+# Utilities
+bun run typecheck        # Check TypeScript
+```
+
+## 🔧 Requirements
+
+- **Bun** >= 1.0.0 (recommended)
+- **Node.js** >= 18.0.0 (fallback)
+
+### Install Bun
+
+```bash
+# Install Bun (if not already installed)
+curl -fsSL https://bun.sh/install | bash
+```
+
+## 🎨 Customization
+
+### Environment Variables
+
+The generated app uses these environment variables (in `.env`):
+
+```bash
+NODE_ENV=development
+PORT=3000
+HOST=localhost
+VITE_PORT=5173
+VITE_API_URL=http://localhost:3000
+```
+
+### Adding Routes
+
+Backend routes in `app/server/routes/`:
+
+```typescript
+// app/server/routes/users.ts
+import { Elysia } from 'elysia'
+
+export const userRoutes = new Elysia({ prefix: '/users' })
+  .get('/', () => ({ users: [] }))
+  .post('/', ({ body }) => ({ user: body }))
+```
+
+Frontend API calls with type safety:
+
+```typescript
+// app/client/src/components/Users.tsx
+import { api } from '../lib/api'
+
+const users = await api.users.get() // ✅ Fully typed!
+```
+
+## 🚀 Deployment
+
+### Option 1: Single Server (Recommended)
+
+```bash
+# Build everything
+bun run build
+
+# Start production server
+bun run start
+```
+
+### Option 2: Separate Deploy
+
+```bash
+# Backend
+bun run build:backend
+bun dist/index.js
+
+# Frontend
+bun run build:frontend
+# Deploy dist/ folder to CDN
+```
+
+## 🤝 Examples
+
+### Basic CRUD API
+
+```typescript
+// app/server/routes/posts.ts
+export const postRoutes = new Elysia({ prefix: '/posts' })
+  .get('/', () => ({ posts: [] }))
+  .post('/', ({ body }) => ({ id: 1, ...body }))
+  .get('/:id', ({ params }) => ({ id: params.id }))
+```
+
+### Frontend Integration
+
+```typescript
+// app/client/src/hooks/usePosts.ts
+import { api } from '../lib/api'
+
+export function usePosts() {
+  return useQuery({
+    queryKey: ['posts'],
+    queryFn: () => api.posts.get()
+  })
+}
+```
+
+## 🛟 Troubleshooting
+
+### Port Already in Use
+
+```bash
+# Kill processes on ports
+pkill -f "3000"
+pkill -f "5173"
+```
+
+### Type Errors
+
+```bash
+# Regenerate types
+bun run typecheck
+```
+
+### Environment Issues
+
+```bash
+# Force development mode
+NODE_ENV=development bun run dev
+```
+
+## 📖 Learn More
+
+- [FluxStack Documentation](https://fluxstack.dev)
+- [Bun Runtime](https://bun.sh)
+- [Elysia.js](https://elysiajs.com)
+- [React 19](https://react.dev)
+
+## 🐛 Issues & Contributing
+
+Found a bug? Have a suggestion?
+- [GitHub Issues](https://github.com/fluxstack/create-fluxstack/issues)
+- [GitHub Discussions](https://github.com/fluxstack/create-fluxstack/discussions)
+
+## 📄 License
+
+MIT © FluxStack Team
+
+---
+
+**Happy coding with the divine Bun runtime! ⚡🔥**

package/app/client/README.md

@@ -0,0 +1,69 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) for Fast Refresh
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default tseslint.config([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      ...tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      ...tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      ...tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x'
+import reactDom from 'eslint-plugin-react-dom'
+
+export default tseslint.config([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```

package/app/client/frontend-only.ts

@@ -0,0 +1,12 @@
+// Frontend standalone entry point
+import { startFrontendOnly } from "../../core/client/standalone"
+
+// Configuração para frontend standalone
+const frontendConfig = {
+  clientPath: "app/client",
+  vitePort: (globalThis as any).process?.env?.FRONTEND_PORT || 5173,
+  apiUrl: (globalThis as any).process?.env?.API_URL || "http://localhost:3001"
+}
+
+// Iniciar apenas o frontend
+startFrontendOnly(frontendConfig)

package/app/client/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Vite + React + TS</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/app/client/public/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>