Skip to content

Commit 7ce4f97

Browse files
committed
Tutorial: drop the Next.js 16 downgrade workaround
Fedify CLI 2.1.8 ships with `@fedify/next` 2.1.8, whose peer dependency on `next` was widened to `>=15.4.6 <17`, so `fedify init -w next` against the current `create-next-app` now installs Next.js 16 cleanly without the manual `package.json` edit the tutorial used to describe. Remove the WARNING callout and the pinning block, and update the prereq sentence in [*Installing the `fedify` command*] to require CLI 2.1.8 or higher (the version that gained Next.js 16 support) rather than the 2.2.0 it previously named. Also bump the Next.js version printed in the sample *npm run dev* console output from 15.5.15 to 16.2.4 so it matches what a reader actually sees. The `fedify-dev/threadiverse` example repository has been updated to the same dependency versions in a paired commit. [*Installing the `fedify` command*]: https://fedify.dev/tutorial/threadiverse#installing-the-fedify-command Resolves #713.
1 parent 6381860 commit 7ce4f97

1 file changed

Lines changed: 4 additions & 30 deletions

File tree

docs/tutorial/threadiverse.md

Lines changed: 4 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -146,10 +146,9 @@ Check that it works:
146146
fedify --version
147147
~~~~
148148

149-
Make sure the version number is 2.2.0 or higher. Older versions of the CLI
150-
don't know how to scaffold a Next.js project, and the `@fedify/fedify`
151-
release we depend on for outbound interop with Lemmy was cut alongside
152-
CLI 2.2.
149+
Make sure the version number is 2.1.8 or higher. Older versions of the
150+
CLI don't know how to scaffold a Next.js 16 project, and this tutorial
151+
was written against the shape that CLI 2.1.8+ produces.
153152

154153
### `fedify init` to initialize the project
155154

@@ -173,31 +172,6 @@ serve ActivityPub. The options mean:
173172
- `-m in-process`: run Fedify's background message queue in-process instead
174173
of on an external broker (Redis, RabbitMQ, and so on).
175174

176-
> [!WARNING]
177-
> At the time of writing, `create-next-app` (which `fedify init` runs under
178-
> the hood) defaults to Next.js 16, but `@fedify/next` 2.1.x still requires
179-
> Next.js 15.4 or later in the 15.x line. After `fedify init` finishes it
180-
> will try to run `npm install` and fail with an `ERESOLVE` error. Open
181-
> *package.json*, change the `next`, `react`, `react-dom`, and
182-
> `eslint-config-next` versions so they point at Next.js 15.5.x, then run
183-
> `npm install` again:
184-
>
185-
> ~~~~ json
186-
> "dependencies": {
187-
> "next": "^15.5.15",
188-
> "react": "^19.2.4",
189-
> "react-dom": "^19.2.4",
190-
> ...
191-
> },
192-
> "devDependencies": {
193-
> ...
194-
> "eslint-config-next": "^15.5.15",
195-
> ...
196-
> }
197-
> ~~~~
198-
>
199-
> This workaround will go away once Fedify ships support for Next.js 16.
200-
201175
After a moment your working directory will contain something like this:
202176

203177
- *app/* — Next.js App Router pages and layouts
@@ -239,7 +213,7 @@ The dev server will keep running until you press
239213
<kbd>Ctrl</kbd>+<kbd>C</kbd>:
240214

241215
~~~~ console
242-
▲ Next.js 15.5.15
216+
▲ Next.js 16.2.4
243217
- Local: http://localhost:3000
244218
- Network: http://192.168.x.x:3000
245219

0 commit comments

Comments
 (0)