create-rex-app 1.0.0

package/template-mongo/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "the-react-experiment",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "nodemon --watch server.js --watch api server.js",
+    "build": "vite build",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@tailwindcss/vite": "^4.2.0",
+    "@tanstack/react-query": "^5.90.21",
+    "axios": "^1.13.5",
+    "bcryptjs": "^3.0.3",
+    "dotenv": "^17.3.1",
+    "express": "^5.2.1",
+    "jsonwebtoken": "^9.0.3",
+    "mongoose": "^9.2.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-router-dom": "^7.13.0",
+    "tailwindcss": "^4.2.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.4",
+    "eslint": "^10.0.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.0",
+    "globals": "^17.3.0",
+    "nodemon": "^3.1.13",
+    "vite": "^7.3.1"
+  }
+}

package/template-mongo/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>

package/template-mongo/server.js

@@ -0,0 +1,80 @@
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import express from 'express'
+import apiRoutes from './api/routes.js'
+import dotenv from 'dotenv';
+import connectDB from './api/db.js';
+
+// Load env vars
+dotenv.config();
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const isProduction = process.env.NODE_ENV === 'production'
+const PORT = process.env.PORT || 5173
+const app = express()
+async function createServer(app) {
+  // const app = express() -commented
+  
+  // 1. Middleware
+  app.use(express.json());
+  
+  // 2. Connect Database
+  connectDB();
+
+  // 3. API Routes (Always load these first)
+  app.use('/api', apiRoutes)
+
+  // ---------------------------------------------------------
+  // 🚀 PRODUCTION MODE (When deployed to Render/Vercel)
+  // ---------------------------------------------------------
+  if (isProduction) {
+    console.log('🚀 Running in PRODUCTION mode');
+    
+    // Serve static files from the 'dist' folder (created by npm run build)
+    app.use(express.static(path.resolve(__dirname, 'dist')));
+
+    // SPA Fallback: Send index.html for any unknown route (so React Router works)
+    app.get(/.*/,(req, res) => {
+      res.sendFile(path.resolve(__dirname, 'dist', 'index.html'));
+    });
+  } 
+  
+  // ---------------------------------------------------------
+  // 🛠️ DEVELOPMENT MODE (Localhost)
+  // ---------------------------------------------------------
+  else {
+    console.log('🛠️ Running in DEVELOPMENT mode');
+    
+    // We only import Vite in dev mode to save memory in prod
+    const { createServer: createViteServer } = await import('vite')
+
+    const vite = await createViteServer({
+      server: { middlewareMode: true },
+      appType: 'custom'
+    })
+
+    app.use(vite.middlewares)
+
+    app.use(async (req, res, next) => {
+      const url = req.originalUrl
+      try {
+        let template = fs.readFileSync(path.resolve(__dirname, 'index.html'), 'utf-8')
+        template = await vite.transformIndexHtml(url, template)
+        res.status(200).set({ 'Content-Type': 'text/html' }).end(template)
+      } catch (e) {
+        vite.ssrFixStacktrace(e)
+        next(e)
+      }
+    })
+  }
+
+  // 4. Start Server
+  app.listen(PORT, () => {
+    console.log(`Server running at http://localhost:${PORT}`)
+  })
+}
+
+createServer(app);
+
+export default app;

package/template-mongo/src/App.css

@@ -0,0 +1,42 @@
+#root {
+  max-width: 1280px;
+  margin: 0 auto;
+  padding: 2rem;
+  text-align: center;
+}
+
+.logo {
+  height: 6em;
+  padding: 1.5em;
+  will-change: filter;
+  transition: filter 300ms;
+}
+.logo:hover {
+  filter: drop-shadow(0 0 2em #646cffaa);
+}
+.logo.react:hover {
+  filter: drop-shadow(0 0 2em #61dafbaa);
+}
+
+@keyframes logo-spin {
+  from {
+    transform: rotate(0deg);
+  }
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+@media (prefers-reduced-motion: no-preference) {
+  a:nth-of-type(2) .logo {
+    animation: logo-spin infinite 20s linear;
+  }
+}
+
+.card {
+  padding: 2em;
+}
+
+.read-the-docs {
+  color: #888;
+}

package/template-mongo/src/App.jsx

@@ -0,0 +1,42 @@
+import { BrowserRouter as Router, Routes, Route } from 'react-router-dom'
+import Layout from './components/Layout'
+import RequireAuth from './components/RequireAuth' // <--- Import the Guard
+import PublicOnly from './components/PublicOnly'
+// Pages
+import Home from './pages/Home'
+import Signup from './pages/Signup'
+import Login from './pages/Login'
+import Docs from './pages/Docs'
+
+function App() {
+  return (
+    <Router>
+      <Routes>
+        <Route path="/" element={<Layout />}>
+          
+          {/* Public Routes (Accessible by everyone) */}
+          <Route index element={<Home />} />
+          {/* 🔓 PUBLIC ONLY ROUTES (Guests) */}
+          {/* If you are logged in, you can't go here! */}
+          <Route element={<PublicOnly />}>
+            <Route path="signup" element={<Signup />} />
+            <Route path="login" element={<Login />} />
+          </Route>
+
+          {/* 🔒 PROTECTED ROUTES (Wrapped in Middleware) */}
+          <Route element={<RequireAuth />}>
+            
+            {/* Any route put inside here is automatically protected! */}
+            <Route path="docs" element={<Docs />} />
+            {/* <Route path="dashboard" element={<Dashboard />} /> */}
+            {/* <Route path="settings" element={<Settings />} /> */}
+            
+          </Route>
+
+        </Route>
+      </Routes>
+    </Router>
+  )
+}
+
+export default App

package/template-mongo/src/assets/react.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="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>

package/template-mongo/src/components/Layout.jsx

@@ -0,0 +1,85 @@
+import { Outlet, Link } from 'react-router-dom'
+import { useAuthContext } from '../hooks/useAuthContext'
+
+const Layout = () => {
+  const { user, dispatch } = useAuthContext()
+
+  const handleLogout = () => {
+    // 1. Remove from Local Storage
+    localStorage.removeItem('user')
+    // 2. Clear Global State
+    dispatch({ type: 'LOGOUT' })
+  }
+
+  return (
+    <div className="min-h-screen bg-[#07070A] text-[#E2E8F0] font-sans flex flex-col selection:bg-purple-500/30">
+      {/* Sleek Glassmorphism Header */}
+      <header className="border-b border-white/5 bg-[#07070A]/80 backdrop-blur-xl sticky top-0 z-50">
+        <nav className="max-w-7xl mx-auto px-6 lg:px-8 h-16 flex justify-between items-center">
+          
+          {/* Rex Logo */}
+          <Link to="/" className="flex items-center gap-3 group">
+            <div className="h-8 w-8 rounded-lg flex items-center justify-center overflow-hidden shadow-lg group-hover:shadow-purple-500/40 transition-all">
+              <img src="/rex.png" alt="Rex" className="w-full h-full object-cover" />
+            </div>
+            <span className="font-bold text-xl text-white tracking-tight">rex</span>
+          </Link>
+          
+          <div className="flex gap-6 font-medium items-center text-sm">
+            <Link to="/" className="text-slate-400 hover:text-white transition-colors">Home</Link>
+            
+            {/* CONDITIONAL RENDERING */}
+            {user ? (
+              // If Logged In:
+              <div className="flex items-center gap-4">
+                
+                <div className="flex items-center gap-2">
+                  {/* 1. NAME (with Email Tooltip) */}
+                  <span 
+                    title={user.email}
+                    className="text-xs font-semibold text-slate-300 border border-white/10 px-3 py-1.5 rounded-lg bg-white/5 cursor-help transition-colors hover:bg-white/10 hover:text-white"
+                  >
+                    {user.name}
+                  </span>
+                  
+                  {/* 2. ROLE BADGE */}
+                  <span className="text-[10px] font-bold uppercase tracking-widest text-purple-400 bg-purple-500/10 border border-purple-500/20 px-2 py-1 rounded-md">
+                    {user.role}
+                  </span>
+                </div>
+
+                {/* 3. LOGOUT BUTTON */}
+                <button 
+                  onClick={handleLogout}
+                  className="bg-red-500/10 hover:bg-red-500/20 border border-red-500/20 text-red-400 hover:text-red-300 px-4 py-1.5 rounded-lg text-sm font-semibold transition-all"
+                >
+                  Logout
+                </button>
+              </div>
+            ) : (
+              // If Logged Out:
+              <div className="flex items-center gap-5">
+                <Link to="/login" className="text-slate-400 hover:text-white transition-colors">
+                  Login
+                </Link>
+                <Link to="/signup" className="bg-gradient-to-r from-purple-600 to-orange-500 hover:from-purple-500 hover:to-orange-400 text-white px-5 py-1.5 rounded-lg shadow-[0_0_15px_rgba(124,58,237,0.3)] hover:shadow-[0_0_25px_rgba(124,58,237,0.5)] transition-all font-semibold">
+                  Sign Up
+                </Link>
+              </div>
+            )}
+          </div>
+        </nav>
+      </header>
+
+      {/* Main Content Area */}
+      <main className="flex-grow max-w-7xl w-full mx-auto px-6 lg:px-8 py-10 relative">
+        {/* Optional subtle glow behind the content */}
+        <div className="absolute top-0 left-1/2 -translate-x-1/2 w-[800px] h-[400px] bg-purple-600/5 blur-[120px] pointer-events-none rounded-full -z-10"></div>
+        
+        <Outlet />
+      </main>
+    </div>
+  )
+}
+
+export default Layout

package/template-mongo/src/components/PublicOnly.jsx

@@ -0,0 +1,17 @@
+import { useAuthContext } from '../hooks/useAuthContext'
+import { Navigate, Outlet } from 'react-router-dom'
+
+const PublicOnly = () => {
+  const { user } = useAuthContext()
+
+  // 1. Check: Is the user logged in?
+  if (user) {
+    // 2. If YES: Kick them to Home (they don't need to login again!)
+    return <Navigate to="/" replace />
+  }
+
+  // 3. If NO: Allow access to the page (Login/Signup)
+  return <Outlet />
+}
+
+export default PublicOnly

package/template-mongo/src/components/RequireAuth.jsx

@@ -0,0 +1,20 @@
+import { useAuthContext } from '../hooks/useAuthContext'
+import { Navigate, useLocation, Outlet } from 'react-router-dom'
+
+const RequireAuth = () => {
+  const { user } = useAuthContext()
+  const location = useLocation()
+
+  // 1. Check: Is the user logged in?
+  if (!user) {
+    // 2. If NO: Redirect to Login
+    // (replace: true keeps the history clean so back button works better)
+    // (state: saves where they were trying to go, so we can send them back after login if we want)
+    return <Navigate to="/login" state={{ from: location }} replace />
+  }
+
+  // 3. If YES: Render the child routes (The protected page)
+  return <Outlet />
+}
+
+export default RequireAuth

package/template-mongo/src/context/AuthContext.jsx

@@ -0,0 +1,35 @@
+import { createContext, useReducer, useEffect } from 'react'
+
+export const AuthContext = createContext()
+
+export const authReducer = (state, action) => {
+  switch (action.type) {
+    case 'LOGIN':
+      return { user: action.payload, authIsReady: true }
+    case 'LOGOUT':
+      return { user: null, authIsReady: true }
+    case 'AUTH_READY': // <--- New action
+      return { user: action.payload, authIsReady: true }
+    default:
+      return state
+  }
+}
+
+export const AuthContextProvider = ({ children }) => {
+  const [state, dispatch] = useReducer(authReducer, { 
+    user: null,
+    authIsReady: false // <--- Start as FALSE
+  })
+
+  useEffect(() => {
+    const user = JSON.parse(localStorage.getItem('user'))
+    // Even if user is null, we are "Ready" because the check is done
+    dispatch({ type: 'AUTH_READY', payload: user })
+  }, [])
+
+  return (
+    <AuthContext.Provider value={{ ...state, dispatch }}>
+      { children }
+    </AuthContext.Provider>
+  )
+}

package/template-mongo/src/hooks/useAuthContext.js

@@ -0,0 +1,11 @@
+// src/hooks/useAuthContext.js
+import { AuthContext } from '../context/AuthContext'
+import { useContext } from 'react'
+
+export const useAuthContext = () => {
+  const context = useContext(AuthContext)
+  if (!context) {
+    throw Error('useAuthContext must be used inside an AuthContextProvider')
+  }
+  return context
+}

package/template-mongo/src/hooks/useLogin.js

@@ -0,0 +1,42 @@
+import { useMutation } from '@tanstack/react-query'
+import axios from 'axios'
+import { useNavigate } from 'react-router-dom'
+import { useAuthContext } from './useAuthContext'
+
+const loginAndFetchUser = async (credentials) => {
+  // 1. Login to get the token
+  const loginRes = await axios.post('/api/login', credentials)
+  const token = loginRes.data.token
+
+  // 2. Use the token to fetch user details immediately
+  const profileRes = await axios.get('/api/profile', {
+    headers: { Authorization: `Bearer ${token}` }
+  })
+
+  // 3. Return combined data (Token + User Info)
+  return { 
+    token, 
+    ...profileRes.data 
+  }
+}
+
+export const useLogin = () => {
+  const navigate = useNavigate()
+  const { dispatch } = useAuthContext()
+
+  return useMutation({
+    mutationFn: loginAndFetchUser, // <--- New function
+    onSuccess: (data) => {
+      // 'data' now contains { token, name, email, role, ... }
+      
+      localStorage.setItem('user', JSON.stringify(data))
+      dispatch({ type: 'LOGIN', payload: data })
+      
+      navigate('/')
+    },
+    onError: (error) => {
+      const message = error.response?.data?.message || 'Login failed'
+      alert(`❌ Error: ${message}`)
+    }
+  })
+}

package/template-mongo/src/hooks/useSignup.js

@@ -0,0 +1,23 @@
+import { useMutation } from '@tanstack/react-query'
+import axios from 'axios'
+
+const signupUser = async (userData) => {
+  // userData is { name, email, password }
+  const response = await axios.post('/api/users', userData)
+  return response.data
+}
+
+export const useSignup = () => {
+  return useMutation({
+    mutationFn: signupUser,
+    onSuccess: (data) => {
+      
+      alert(`Welcome, ${data.name}! Account created.`)
+    },
+    onError: (error) => {
+      // Extract the error message from the backend response
+      const message = error.response?.data?.message || 'Signup failed'
+      alert(`Error: ${message}`)
+    }
+  })
+}

package/template-mongo/src/hooks/useTest.js

@@ -0,0 +1,18 @@
+import axios from 'axios'
+import { useQuery } from '@tanstack/react-query'
+
+// The Fetcher (Private to this file mostly, or exported if needed elsewhere)
+const fetchServerMessage = async () => {
+  const response = await axios.get('/api/test')
+  return response.data
+}
+
+// The Custom Hook
+export const useTest = () => {
+  return useQuery({
+    queryKey: ['serverMessage'],
+    queryFn: fetchServerMessage,
+    // You can add default options here if you want (e.g., staleTime)
+    staleTime: 1000 * 60 * 5, // Data is fresh for 5 minutes
+  })
+}

package/template-mongo/src/index.css

@@ -0,0 +1 @@
+@import "tailwindcss";

package/template-mongo/src/main.jsx

@@ -0,0 +1,18 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import './index.css'
+import App from './App.jsx'
+import { AuthContextProvider } from './context/AuthContext'
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+
+const queryClient = new QueryClient()
+createRoot(document.getElementById('root')).render(
+  <StrictMode>
+    <AuthContextProvider>
+      <QueryClientProvider client={queryClient}>
+        <App />
+      </QueryClientProvider>
+    </AuthContextProvider>
+
+  </StrictMode>,
+)

package/template-mongo/src/pages/Docs.jsx

@@ -0,0 +1,131 @@
+const Docs = () => {
+  return (
+    <div className="max-w-4xl mx-auto py-8 z-10 relative">
+      
+      {/* BACKGROUND GLOW */}
+      <div className="absolute top-0 left-1/2 -translate-x-1/2 w-[600px] h-[300px] bg-blue-500/10 blur-[100px] pointer-events-none -z-10"></div>
+
+      <div className="bg-white/[0.02] rounded-3xl shadow-2xl border border-white/10 backdrop-blur-md overflow-hidden">
+        
+        {/* HEADER */}
+        <div className="p-8 sm:p-10 border-b border-white/10 bg-black/20">
+          <div className="inline-flex items-center gap-2 bg-blue-500/10 border border-blue-500/20 text-blue-400 px-3 py-1 rounded-full text-xs font-mono font-bold uppercase tracking-wider mb-4">
+            <span className="w-1.5 h-1.5 rounded-full bg-blue-400 animate-pulse"></span>
+            MongoDB Template
+          </div>
+          <h1 className="text-4xl sm:text-5xl font-extrabold text-white tracking-tight mb-4">
+            Boilerplate <span className="bg-gradient-to-r from-blue-400 to-emerald-400 bg-clip-text text-transparent">Overview</span>
+          </h1>
+          <p className="text-slate-400 text-lg max-w-2xl">
+            You've successfully scaffolded the Rex MongoDB template. Here is a brief guide to the architecture and auth flow of this specific stack.
+          </p>
+        </div>
+
+        {/* CONTENT */}
+        <div className="p-8 sm:p-10 space-y-12 text-slate-300">
+          
+          {/* Section 1: The Stack */}
+          <section>
+            <h2 className="text-2xl font-bold text-white mb-4 flex items-center gap-3">
+              <span className="text-blue-400">01.</span> The Stack
+            </h2>
+            <div className="grid sm:grid-cols-2 gap-4">
+              <div className="bg-black/30 p-4 rounded-xl border border-white/5">
+                <div className="text-xs text-slate-500 font-mono mb-1">Frontend</div>
+                <div className="font-semibold text-white">React + Vite + Tailwind</div>
+              </div>
+              <div className="bg-black/30 p-4 rounded-xl border border-white/5">
+                <div className="text-xs text-slate-500 font-mono mb-1">Backend</div>
+                <div className="font-semibold text-white">Node.js + Express</div>
+              </div>
+              <div className="bg-black/30 p-4 rounded-xl border border-white/5">
+                <div className="text-xs text-slate-500 font-mono mb-1">Database</div>
+                <div className="font-semibold text-white">MongoDB (Mongoose)</div>
+              </div>
+              <div className="bg-black/30 p-4 rounded-xl border border-white/5">
+                <div className="text-xs text-slate-500 font-mono mb-1">Security</div>
+                <div className="font-semibold text-white">JWT Authentication</div>
+              </div>
+            </div>
+          </section>
+
+          {/* Section 2: Auth Flow */}
+          <section>
+            <h2 className="text-2xl font-bold text-white mb-4 flex items-center gap-3">
+              <span className="text-emerald-400">02.</span> Auth Flow & Guard
+            </h2>
+            <p className="mb-4 text-slate-400">
+              Authentication is handled via JWT. Instead of checking for a user on every page, we use a Wrapper Component called <code className="text-emerald-300 bg-emerald-400/10 px-1.5 py-0.5 rounded font-mono text-sm">RequireAuth</code>.
+            </p>
+            
+            <div className="bg-black/50 p-6 rounded-2xl border border-white/5 font-mono text-sm text-slate-400 overflow-x-auto leading-loose">
+              <span className="text-blue-400">// How the Bouncer works conceptually:</span><br/><br/>
+              [ App Router ]<br/>
+              &nbsp;&nbsp;│<br/>
+              &nbsp;&nbsp;├── Public Routes (Home, Login)<br/>
+              &nbsp;&nbsp;│<br/>
+              &nbsp;&nbsp;└── <span className="text-emerald-400">&lt;RequireAuth /&gt;</span> (The Guard 🛡️)<br/>
+              &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;│<br/>
+              &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── Checks Context: <span className="text-white">"Do we have a user?"</span><br/>
+              &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;│<br/>
+              &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── <span className="text-red-400">NO?</span> → Redirects to /login<br/>
+              &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;└── <span className="text-green-400">YES?</span> → Renders the Child Page (Outlet)
+            </div>
+          </section>
+
+          {/* Section 3: File Structure */}
+          <section>
+            <h2 className="text-2xl font-bold text-white mb-4 flex items-center gap-3">
+              <span className="text-yellow-400">03.</span> Project Structure
+            </h2>
+            <p className="mb-4 text-slate-400">
+              This boilerplate is modular. To add a new feature: create a model in <code className="text-yellow-300">api/models</code>, a route in <code className="text-yellow-300">api/routes.js</code>, and a hook in <code className="text-yellow-300">src/hooks</code>.
+            </p>
+            <pre className="bg-black/50 p-6 rounded-2xl border border-white/5 text-xs sm:text-sm text-slate-300 overflow-x-auto leading-relaxed font-mono">
+{`root/
+├── .env                  `} <span className="text-slate-500">// Secrets (DB URI, JWT Secret)</span>{`
+├── server.js             `} <span className="text-slate-500">// Entry point (Express App)</span>{`
+├── api/                  `} <span className="text-slate-500">// Backend Logic</span>{`
+│   ├── db.js             
+│   ├── routes.js         
+│   ├── models/           `} <span className="text-slate-500">// Mongoose Schemas (User.js)</span>{`
+│   └── middleware/       `} <span className="text-slate-500">// Auth Guard (auth.js)</span>{`
+│
+└── src/                  `} <span className="text-slate-500">// Frontend (React)</span>{`
+    ├── main.jsx          
+    ├── App.jsx           `} <span className="text-slate-500">// Router Definitions</span>{`
+    ├── components/       
+    │   ├── Layout.jsx    
+    │   └── RequireAuth.jsx 
+    ├── context/          `} <span className="text-slate-500">// Global User State</span>{`
+    ├── hooks/            `} <span className="text-slate-500">// React Query Hooks</span>{`
+    └── pages/            `}
+            </pre>
+          </section>
+        </div>
+
+        {/* FOOTER CTA */}
+        <div className="p-8 sm:p-10 border-t border-white/10 bg-black/40 text-center">
+          <h3 className="text-xl font-bold text-white mb-2">Need to know how Rex handles the server?</h3>
+          <p className="text-slate-400 mb-6 text-sm">
+            For deep dives into the unified architecture, Vite middleware, and deployment strategies, read the official framework documentation.
+          </p>
+          <a 
+            href="https://rex-docs.vercel.app/" 
+            target="_blank" 
+            rel="noopener noreferrer"
+            className="inline-flex items-center justify-center gap-2 bg-white/5 hover:bg-white/10 border border-white/10 hover:border-purple-500/50 text-white px-6 py-2.5 rounded-lg font-semibold transition-all"
+          >
+            Read Official Rex Docs
+            <svg width="16" height="16" fill="none" viewBox="0 0 24 24" stroke="currentColor" strokeWidth="2">
+              <path strokeLinecap="round" strokeLinejoin="round" d="M10 6H6a2 2 0 00-2 2v10a2 2 0 002 2h10a2 2 0 002-2v-4M14 4h6m0 0v6m0-6L10 14" />
+            </svg>
+          </a>
+        </div>
+
+      </div>
+    </div>
+  )
+}
+
+export default Docs