Docs : guide deploy-on-clever

src/content/docs/guides/deploy-on-clever-cloud.mdx

@@ -0,0 +1,87 @@
+---
+title: Deploy on Clever Cloud 
+---
+
+import { Steps} from "@astrojs/starlight/components";
+
+
+This guide explains how to deploy your start-ui-v3 project to Clever Cloud using the Clever Tools CLI.
+
+<Steps>
+1. Create a new Clever Cloud application
+
+   - Go to the [Clever Console](https://console.clever-cloud.com/) and select your personal organization or the organization where you want to create your app.
+
+   - Click on "Create..." and select "an application".
+
+   ![deploy-on-clever-1](@/assets/guides/deploy-on-clever/deploy-on-clever-1.png)
+
+
+   - Select "Create a brand new app"
+   - Select "NodeJS & Bun" as the template.
+
+   ![deploy-on-clever-2](@/assets/guides/deploy-on-clever/deploy-on-clever-2.png)
+
+   - Choose the recommended machine for your project, but you can edit it later.
+   - Give a name to your app (description is optional).
+
+2. Configure environment variables 
+
+   - In the left sidebar, open your project and click Environment Variables.
+      <div style={{ display: "flex", gap: "16px", alignItems: "center" }}>
+         <div>
+            <img src="/src/assets/guides/deploy-on-clever/deploy-on-clever-3-1.png" />
+         </div>
+         <div>
+            <img src="/src/assets/guides/deploy-on-clever/deploy-on-clever-3-2.png" />
+         </div>
+      </div>
+
+
+   - At the top right, select the Expert tab.
+   ![deploy-on-clever-3-3](@/assets/guides/deploy-on-clever/deploy-on-clever-3-3.png)
+   - Paste the environment variable template provided below.
+   - Replace all variables as needed to match your project (including your domain)
+   - Once done, switch back to the Simple view to see your variables listed.
+         ```
+         # Clever Cloud variables
+         CC_CACHE_DEPENDENCIES="false"
+         CC_CUSTOM_BUILD_TOOL="pnpm install && pnpm build"
+         CC_NODE_BUILD_TOOL="custom"
+         CC_NODE_DEV_DEPENDENCIES="install"
+         CC_PRE_BUILD_HOOK="npm install -g pnpm"
+         CC_RUN_COMMAND="pnpm start || (npm install -g pnpm && pnpm start)"
+
+         # Start-UI required variables
+         AUTH_SECRET="REPLACE ME"
+         AUTH_SESSION_EXPIRATION_IN_SECONDS="2592000"
+         AUTH_SESSION_UPDATE_AGE_IN_SECONDS="86400"
+         DATABASE_URL="REPLACE_ME"
+         EMAIL_FROM="Start UI <noreply@example.com>"
+         EMAIL_SERVER="smtp://your-smtp-server"
+         NODE_ENV="production"
+         GITHUB_CLIENT_ID="REPLACE ME" #optional if NODE_ENV != production
+         GITHUB_CLIENT_SECRET="REPLACE ME" #optional if NODE_ENV != production
+         VITE_BASE_URL="REPLACE ME"
+
+         # Optional
+         VITE_ENV_NAME="PROD-STAGING-YOUR_ENV"
+         VITE_PORT="3000"
+
+         VITE_ENV_EMOJI="🚧"
+         VITE_ENV_COLOR="gold"
+         VITE_IS_DEMO="false"
+         ```
+
+3. Deploy your app:
+
+    - Open a terminal in your project
+    ```bash
+      npm install -g clever-tools
+      clever login
+      clever link app_YOUR_ID_APP
+      clever deploy
+    ```
+</Steps>
+
+🎉 Once the deployment command completes successfully, your app will be live on Clever Cloud !