1. Docs
  2. Next.js

Finch on a Next.js site.

Finch works on Next.js sites with no extra setup: /finch-install finds the right place for it.

Install

Paste this into Claude Code, then run /finch-install in a new session in your project:

Claude Code
Add the Claude Code plugin finch@finch from the GitHub marketplace usefinch/notes (put it in my Claude Code settings if /plugin isn’t available here), then tell me how to load it and run /finch-install on this site.

Full steps are on the install page.

How Finch knows it’s Next.js
It looks for next.config.js, .mjs or .ts, then app/layout or pages/_app to tell the routers apart.
Where the script goes
Two next/script tags inside <body> in app/layout (App Router), or in pages/_app (Pages Router). That’s the only change to your site’s code.

Good to know

  • Works with both routers, with or without a src/ folder.
  • If an image change needs a new image host, Claude adds only Unsplash or Pexels to next.config, and Claude Code asks you before that edit.
  • Most Next.js sites deploy on push to Vercel, which /finch-apply uses after merging.