Skip to content

Deploy Guide

This guide explains how to deploy your start-ui-v3 project to Clever Cloud using the Clever Tools CLI.

  1. Create a new Clever Cloud application

    • Go to the Clever Console 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

    • Select “Create a brand new app”
    • Select “NodeJS & Bun” as the template.

    deploy-on-clever-2

    • 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 Replace all variables as needed to match your project (including your domain)

    • Go back to your project on the left bar and click on “Environment Variable”.
    • Click on the Expert tab at the top right.
    • Paste the environment variable template below, then switch back to the Simple view.

    deploy-on-clever-3

    AUTH_SECRET="REPLACE ME"
    AUTH_SESSION_EXPIRATION_IN_SECONDS="2592000"
    AUTH_SESSION_UPDATE_AGE_IN_SECONDS="86400"
    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)"
    DATABASE_URL="REPLACE_ME"
    EMAIL_FROM="Start UI <noreply@example.com>"
    EMAIL_SERVER="smtp://your-smtp-server"
    NODE_ENV="production"
    VITE_BASE_URL="REPLACE ME"
    VITE_ENV_COLOR="gold"
    VITE_ENV_EMOJI="🚧"
    VITE_ENV_NAME="PROD-STAGING-YOUR_ENV"
    VITE_IS_DEMO="false"
    VITE_PORT="3000"
  3. Deploy your app:

    • Open a terminal in your project
    Terminal window
    npm install -g clever-tools
    clever login
    clever link <app_id>
    clever deploy

🎉 Your app is now live on Clever Cloud! You can view logs or redeploy anytime using clever logs and clever deploy.