Add Nuxt as a web framework option in `fedify init` by 2chanhaeng · Pull Request #675 · fedify-dev/fedify

2chanhaeng · 2026-04-13T03:13:05Z

Add Nuxt as a web framework option in `fedify init`

Depends on #674.

Changes

`@fedify/init`

Added Nuxt as a selectable web framework in fedify init.
Users can now scaffold a new Fedify project with Nuxt integration
across all supported package managers (npm, pnpm, yarn, Bun, Deno).

New files

src/webframeworks/nuxt.ts: WebFrameworkDescription for Nuxt,
including nuxi init scaffolding command, dependency resolution for
both Node.js and Deno environments, and template file mapping.
src/templates/nuxt/nuxt.config.ts.tpl: Minimal Nuxt config
template with SSR disabled and devtools enabled.
src/templates/nuxt/server/federation.ts.tpl: Federation
instance setup with MemoryKvStore and a basic actor dispatcher.
src/templates/nuxt/server/logging.ts.tpl: LogTape
configuration for Nuxt and Fedify loggers.
src/templates/nuxt/server/middleware/federation.ts.tpl: Nitro
event handler that delegates requests to federation.fetch(),
falling through to Nuxt on 404.

Modified files

src/const.ts: Added "nuxt" to the WEB_FRAMEWORK array.
src/webframeworks/mod.ts: Imported and registered the Nuxt
framework description.
src/json/deps.json: Added @nuxt/kit, h3, nuxi, and
nuxt version pins.
src/test/port.ts: Added port replacement logic for Nuxt
(injects nitro.port into nuxt.config.ts).

Co-Authored-By: GPT-5.4

coderabbitai · 2026-04-13T03:13:12Z

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: e5649acc-d537-45a1-884b-154699b40195

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

gemini-code-assist

Code Review

This pull request introduces the @fedify/nuxt package to provide seamless integration between Fedify and the Nuxt framework, alongside updates to the fedify init tool for project scaffolding. The review feedback correctly identifies a critical bug in the Nuxt middleware template where the request body is ignored during manual Request construction, suggesting the use of toWebRequest from h3 as a fix. Furthermore, the feedback recommends enabling the @fedify/nuxt module by default in generated projects to simplify the setup and points out a typo in the Node.js type definitions version.

gemini-code-assist · 2026-04-13T03:16:33Z

packages/init/src/templates/nuxt/server/middleware/federation.ts.tpl

+  // Construct the full URL from headers
+  const proto = event.headers.get("x-forwarded-proto") || "http";
+  const host = event.headers.get("host") || "localhost";
+  const url = new URL(event.node.req.url || "", `${proto}://${host}`);
+
+  const request = new Request(url, {
+    method: event.node.req.method,
+    headers: event.node.req.headers as Record<string, string>,
+    body: ["GET", "HEAD", "DELETE"].includes(event.node.req.method)
+      ? undefined
+      : undefined,
+  });


The manual construction of the Request object is incomplete and contains a bug: the body is always set to undefined (lines 13-15), which will break ActivityPub inbox listeners that rely on POST requests.

Using toWebRequest(event) from h3 is the recommended approach as it correctly handles URL construction (including proxy headers), headers, and body streaming, while significantly simplifying the code.

const request = toWebRequest(event);

gemini-code-assist · 2026-04-13T03:16:33Z

packages/init/src/webframeworks/nuxt.ts

+    devDependencies: {
+      ...defaultDevDependencies,
+      "typescript": deps["npm:typescript"],
+      "@types/node": deps["npm:@types/node@25"],


The key npm:@types/node@25 appears to be a typo. Node.js versions currently go up to 23, and the monorepo uses ^22.17.0 (as seen in pnpm-workspace.yaml). This will likely result in an undefined value if the key does not exist in deps.json, causing issues in the scaffolded project.

"@types/node": deps["npm:@types/node"],

gemini-code-assist · 2026-04-13T03:16:33Z

packages/init/src/templates/nuxt/server/middleware/federation.ts.tpl

@@ -0,0 +1,24 @@
+import { defineEventHandler } from "h3";


Import toWebRequest from h3 to simplify request conversion and ensure the request body is correctly handled for all HTTP methods.

import { defineEventHandler, toWebRequest } from "h3";

gemini-code-assist · 2026-04-13T03:16:34Z

packages/init/src/templates/nuxt/nuxt.config.ts.tpl

+export default defineNuxtConfig({
+  ssr: false,
+  devtools: { enabled: true },
+});


The @fedify/nuxt module is installed as a dependency but not enabled in the generated configuration. Enabling the module is the preferred integration method as it provides features like deferred 406 Not Acceptable handling and automatic middleware registration.

If the module is enabled, the manual middleware in server/middleware/federation.ts becomes redundant and should be removed from the template set in packages/init/src/webframeworks/nuxt.ts to avoid duplicate request handling.

export default defineNuxtConfig({ modules: ["@fedify/nuxt"], ssr: false, devtools: { enabled: true }, });

codecov · 2026-04-13T03:25:05Z

Codecov Report

❌ Patch coverage is 42.27642% with 71 lines in your changes missing coverage. Please review.
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
packages/init/src/webframeworks/nuxt.ts	15.27%	61 Missing ⚠️
packages/init/src/test/port.ts	0.00%	10 Missing ⚠️

Files with missing lines	Coverage Δ
packages/init/src/const.ts	`100.00% <100.00%> (ø)`
packages/init/src/webframeworks/mod.ts	`100.00% <100.00%> (ø)`
packages/nuxt/src/runtime/server/lib.ts	`100.00% <100.00%> (ø)`
packages/nuxt/src/runtime/server/logic.ts	`100.00% <100.00%> (ø)`
packages/init/src/test/port.ts	`9.60% <0.00%> (-0.84%)`	⬇️
packages/init/src/webframeworks/nuxt.ts	`15.27% <15.27%> (ø)`

🚀 New features to boost your workflow:

📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

- Use @fedify/fixture instead of node:test in mod.test.ts - Type event parameter as H3Event instead of unknown in middleware.ts Co-Authored-By: Claude (claude-opus-4-20250514)

Move NOT_ACCEPTABLE_BODY and DEFERRED_NOT_ACCEPTABLE_CONTEXT_KEY into a shared lib.ts to avoid string duplication across logic.ts and plugin.ts. Co-Authored-By: Claude (claude-opus-4-20250514)

- Close unclosed bash code fence in SKILL.md - Fix "can not" to "cannot" in SKILL.md - Use asterisk-wrapped file paths in README.md and integration.md Co-Authored-By: Claude (claude-opus-4-20250514)

issues-auto-labeler bot added component/cli CLI tools related component/federation Federation object related component/integration Web framework integration labels Apr 13, 2026

gemini-code-assist bot reviewed Apr 13, 2026

View reviewed changes

2chanhaeng mentioned this pull request Apr 13, 2026

Add Nuxt example application #676

Draft

2chanhaeng added 9 commits April 13, 2026 03:29

Address for improvements skills

c20b6dc

Create @fedify/nuxt with GPT-5.3-codex in one-shot

2037ce7

Add pull request reference for Nuxt changelog entry

e573c2a

Fix imports

363c617

- Use @fedify/fixture instead of node:test in mod.test.ts - Type event parameter as H3Event instead of unknown in middleware.ts Co-Authored-By: Claude (claude-opus-4-20250514)

Extract shared constants into lib.ts

54f7085

Move NOT_ACCEPTABLE_BODY and DEFERRED_NOT_ACCEPTABLE_CONTEXT_KEY into a shared lib.ts to avoid string duplication across logic.ts and plugin.ts. Co-Authored-By: Claude (claude-opus-4-20250514)

Fix docs

475d3a8

- Close unclosed bash code fence in SKILL.md - Fix "can not" to "cannot" in SKILL.md - Use asterisk-wrapped file paths in README.md and integration.md Co-Authored-By: Claude (claude-opus-4-20250514)

Format

7c3f831

Add @fedify/nuxt to @fedify/init with GPT-5.4

d40c2ee

Add Nuxt support entry to @fedify/init changelog

950c914

2chanhaeng force-pushed the init-nuxt branch from b9c7b5e to 950c914 Compare April 13, 2026 04:18

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add Nuxt as a web framework option in `fedify init`#675

Add Nuxt as a web framework option in `fedify init`#675
2chanhaeng wants to merge 9 commits intofedify-dev:mainfrom
2chanhaeng:init-nuxt

2chanhaeng commented Apr 13, 2026

Uh oh!

coderabbitai bot commented Apr 13, 2026 •

edited

Loading

Review skipped

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

gemini-code-assist bot Apr 13, 2026

Uh oh!

gemini-code-assist bot Apr 13, 2026

Uh oh!

gemini-code-assist bot Apr 13, 2026

Uh oh!

gemini-code-assist bot Apr 13, 2026

Uh oh!

codecov bot commented Apr 13, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

2chanhaeng commented Apr 13, 2026

Add Nuxt as a web framework option in fedify init

Changes

@fedify/init

New files

Modified files

Uh oh!

coderabbitai bot commented Apr 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

gemini-code-assist bot Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

codecov bot commented Apr 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Add Nuxt as a web framework option in `fedify init`

`@fedify/init`

coderabbitai bot commented Apr 13, 2026 •

edited

Loading

codecov bot commented Apr 13, 2026 •

edited

Loading