From 7a0b0f7d40169895879a07b310783aa6b782962e Mon Sep 17 00:00:00 2001 From: Christopher Jennings <1398135+ChristopherJennings@users.noreply.github.com> Date: Wed, 29 Jul 2026 20:38:56 -0400 Subject: [PATCH 1/2] Correct local setup info in CLAUDE.md The stated toolchain versions did not match the manifest. package.json declares engines.node ">=22.18" and pins packageManager "pnpm@10.29.2", not Node.js 22 and pnpm 9.15.4. Node 24 and pnpm 10 both satisfy it, so the old text made a working setup look wrong. Also documented that pnpm dev throws "Invalid URL" without DIRECTUS_URL, since the Nuxt server passes it to createDirectus() during render. This is not obvious from the error, which surfaces as a stack trace inside @directus/sdk. Co-Authored-By: Claude Fable 5 --- CLAUDE.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 1d4b3e8a..e5d5d6a3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -9,13 +9,15 @@ Directus documentation site built with Nuxt 3 and `@nuxt/content`. Markdown file ## Commands ```bash -pnpm install # Install dependencies (requires Node.js 22, pnpm 9.15.4) +pnpm install # Install dependencies (requires Node.js >=22.18, pnpm 10.29.2) pnpm dev # Dev server at http://localhost:3000/docs pnpm build # Production build pnpm generate # Static site generation (used for Vercel deploy) pnpm preview # Preview production build locally ``` +`pnpm dev` fails with `Invalid URL` unless `DIRECTUS_URL` is set, because the Nuxt server passes it to `createDirectus()` during render. Copy `.env.example` to `.env` before the first run. For content-only work, `DIRECTUS_URL` is the sole required value; the remaining variables emit warnings and disable search, analytics, and the assistant. + There is no test runner configured. Linting is via `@nuxt/eslint` (run through Nuxt's built-in integration). ## Architecture From ea38eec73d10ed45bfe95643709dad4f2bfd0751 Mon Sep 17 00:00:00 2001 From: Christopher Jennings <1398135+ChristopherJennings@users.noreply.github.com> Date: Thu, 30 Jul 2026 10:42:14 -0400 Subject: [PATCH 2/2] Update to avoid potential loss of custom values --- CLAUDE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index e5d5d6a3..8ea1b59f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -16,7 +16,7 @@ pnpm generate # Static site generation (used for Vercel deploy) pnpm preview # Preview production build locally ``` -`pnpm dev` fails with `Invalid URL` unless `DIRECTUS_URL` is set, because the Nuxt server passes it to `createDirectus()` during render. Copy `.env.example` to `.env` before the first run. For content-only work, `DIRECTUS_URL` is the sole required value; the remaining variables emit warnings and disable search, analytics, and the assistant. +`pnpm dev` fails with `Invalid URL` unless `DIRECTUS_URL` is set, because the Nuxt server passes it to `createDirectus()` during render. Copy any missing environment variables from `.env.example` to `.env` before the first run. For content-only work, `DIRECTUS_URL` is the sole required value; the remaining variables emit warnings and disable search, analytics, and the assistant. There is no test runner configured. Linting is via `@nuxt/eslint` (run through Nuxt's built-in integration).