From e87bd0a75e21abdcb800c1173c7ac365f11ea47b Mon Sep 17 00:00:00 2001 From: Maxime Pauvert Date: Thu, 25 Sep 2025 19:34:19 +0200 Subject: [PATCH 1/4] Refactor environment variable setup for package managers Updated environment variable configurations for various package managers, replacing deprecated hooks and adjusting Node.js version settings. --- content/deploy/clever-cloud.md | 33 ++++++++++++--------------------- 1 file changed, 12 insertions(+), 21 deletions(-) diff --git a/content/deploy/clever-cloud.md b/content/deploy/clever-cloud.md index d2c62614d..33d622efa 100644 --- a/content/deploy/clever-cloud.md +++ b/content/deploy/clever-cloud.md @@ -22,7 +22,7 @@ To deploy your Nuxt project to Clever Cloud, you will need to create a **new app 7. Inject **environment variables**: - For **Node.js** -::package-managers +::code-group{sync="pm"} ```ini [npm] CC_PRE_BUILD_HOOK="npm run build" @@ -30,22 +30,17 @@ CC_RUN_COMMAND="node .output/server/index.mjs" ``` ```ini [yarn] -CC_NODE_BUILD_TOOL="yarn" -CC_PRE_BUILD_HOOK="yarn install --frozen-lockfile && yarn build" +CC_POST_BUILD_HOOK="yarn build" CC_RUN_COMMAND="node .output/server/index.mjs" ``` ```ini [pnpm] -CC_CUSTOM_BUILD_TOOL="pnpm build" -CC_NODE_BUILD_TOOL="custom" -CC_PRE_BUILD_HOOK="npm i -g pnpm && pnpm install --frozen-lockfile && pnpm run build" +CC_POST_BUILD_HOOK="pnpm build" CC_RUN_COMMAND="node .output/server/index.mjs" ``` ```ini [bun] -CC_CUSTOM_BUILD_TOOL="bun build" -CC_NODE_BUILD_TOOL="custom" -CC_PRE_BUILD_HOOK="npm i -g bun && bun install && bun run build " +CC_POST_BUILD_HOOK="bun build" CC_RUN_COMMAND="node .output/server/index.mjs" ``` @@ -53,38 +48,34 @@ CC_RUN_COMMAND="node .output/server/index.mjs" - For a **static application** -::package-managers +::code-group{sync="pm"} ```ini [npm] -CC_NODE_VERSION=20 CC_WEBROOT=/.output/public CC_OVERRIDE_BUILDCACHE=/.output/public CC_PRE_BUILD_HOOK=npm install -CC_POST_BUILD_HOOK=npx nuxi generate +CC_POST_BUILD_HOOK=npm generate ``` ```ini [yarn] -CC_NODE_VERSION=20 CC_WEBROOT=/.output/public CC_OVERRIDE_BUILDCACHE=/.output/public -CC_PRE_BUILD_HOOK="yarn install --frozen-lockfile" -CC_POST_BUILD_HOOK=npx nuxi generate +CC_PRE_BUILD_HOOK=yarn install +CC_POST_BUILD_HOOK=yarn generate ``` ```ini [pnpm] -CC_NODE_VERSION=20 CC_WEBROOT=/.output/public CC_OVERRIDE_BUILDCACHE=/.output/public -CC_PRE_BUILD_HOOK="npm i -g pnpm && pnpm install --frozen-lockfile" -CC_POST_BUILD_HOOK=npx nuxi generate +CC_PRE_BUILD_HOOK=pnpm install +CC_POST_BUILD_HOOK=pnpm generate ``` ```ini [bun] -CC_NODE_VERSION=20 CC_WEBROOT=/.output/public CC_OVERRIDE_BUILDCACHE=/.output/public -CC_PRE_BUILD_HOOK="npm i -g bun && bun install" -CC_POST_BUILD_HOOK=npx nuxi generate +CC_PRE_BUILD_HOOK=bun install +CC_POST_BUILD_HOOK=bun generate ``` :: From 9077a02e32054041e0a4834c8eb1cb402c7af077 Mon Sep 17 00:00:00 2001 From: Maxime Pauvert Date: Sat, 4 Oct 2025 17:32:39 +0200 Subject: [PATCH 2/4] Update clever-cloud.md --- content/deploy/clever-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/deploy/clever-cloud.md b/content/deploy/clever-cloud.md index 33d622efa..655722fe1 100644 --- a/content/deploy/clever-cloud.md +++ b/content/deploy/clever-cloud.md @@ -54,7 +54,7 @@ CC_RUN_COMMAND="node .output/server/index.mjs" CC_WEBROOT=/.output/public CC_OVERRIDE_BUILDCACHE=/.output/public CC_PRE_BUILD_HOOK=npm install -CC_POST_BUILD_HOOK=npm generate +CC_POST_BUILD_HOOK=npm run generate ``` ```ini [yarn] From e5e0daeec4606ca0a8ea6c9f5f33980f0f100c5d Mon Sep 17 00:00:00 2001 From: Maxime Pauvert Date: Thu, 9 Oct 2025 23:57:45 +0200 Subject: [PATCH 3/4] Update content/deploy/clever-cloud.md Co-authored-by: Julia March --- content/deploy/clever-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/deploy/clever-cloud.md b/content/deploy/clever-cloud.md index 655722fe1..7d96b045d 100644 --- a/content/deploy/clever-cloud.md +++ b/content/deploy/clever-cloud.md @@ -25,7 +25,7 @@ To deploy your Nuxt project to Clever Cloud, you will need to create a **new app ::code-group{sync="pm"} ```ini [npm] -CC_PRE_BUILD_HOOK="npm run build" +CC_PRE_BUILD_HOOK="npm install && npm run build" CC_RUN_COMMAND="node .output/server/index.mjs" ``` From e6db4e8842930322972c09a22c62a90fc195e2aa Mon Sep 17 00:00:00 2001 From: Maxime Pauvert Date: Fri, 10 Oct 2025 00:20:02 +0200 Subject: [PATCH 4/4] Modify Clever Cloud deployment instructions Updated Clever Cloud deployment instructions for npm and added note on static applications. --- content/deploy/clever-cloud.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/content/deploy/clever-cloud.md b/content/deploy/clever-cloud.md index 7d96b045d..32e5b996e 100644 --- a/content/deploy/clever-cloud.md +++ b/content/deploy/clever-cloud.md @@ -25,7 +25,7 @@ To deploy your Nuxt project to Clever Cloud, you will need to create a **new app ::code-group{sync="pm"} ```ini [npm] -CC_PRE_BUILD_HOOK="npm install && npm run build" +CC_POST_BUILD_HOOK="npm run build" CC_RUN_COMMAND="node .output/server/index.mjs" ``` @@ -48,6 +48,14 @@ CC_RUN_COMMAND="node .output/server/index.mjs" - For a **static application** +::note +If [`ssr: false` is set in `nuxt.config.ts`](https://nuxt.com/docs/4.x/getting-started/deployment#static-hosting) **or** if your project contains dynamic routes that cannot be pre-rendered, you should : +1. Use a **Static Apache** application +2. Create a [`.htaccess`](https://www.clever.cloud/developers/doc/applications/static-apache/#serving-indexhtml-for-spa-single-page-application-routers) file that redirects all routes to `index.html` to ensure proper routing for your SPA. + +Otherwise, you can use the default **Static HTML** application. +:: + ::code-group{sync="pm"} ```ini [npm]