feat(presets): add `platformatic` preset by p-dubovitsky · Pull Request #4554 · nitrojs/nitro

p-dubovitsky · 2026-08-24T12:14:54Z

🔗 Linked issue

❓ Type of change

📖 Documentation (updates to the documentation, readme, or JSdoc annotations)
🐞 Bug fix (a non-breaking change that fixes an issue)
👌 Enhancement (improving an existing functionality like performance)
✨ New feature (a non-breaking change that adds functionality)
🧹 Chore (updates to the build process or auxiliary tools and libraries)
⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

Adds a built-in platformatic preset.

The preset extends node-server and loads @platformatic/nitro/scheduler when scheduledTasks are configured. Applications without scheduled tasks are unaffected, and experimental.tasks remains an explicit opt-in.

📝 Checklist

I have linked an issue or discussion.
I have updated the documentation accordingly.

vercel · 2026-08-24T12:15:00Z

@p-dubovitsky is attempting to deploy a commit to the Nitro Team on Vercel.

A member of the Team first needs to authorize it.

coderabbitai · 2026-08-24T12:15:19Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0ca3b842-0768-4460-93f3-5291d30d8fc5

📥 Commits

Reviewing files that changed from the base of the PR and between c87b721 and 9d45f87.

📒 Files selected for processing (1)

docs/2.deploy/20.providers/platformatic.md

🚧 Files skipped from review as they are similar to previous changes (1)

docs/2.deploy/20.providers/platformatic.md

Included review availability: Your plan provides up to 10 included reviews per hour; 7 remain after this review.

📝 Walkthrough

Walkthrough

The PR adds a Platformatic Nitro preset with platformatic and watt aliases. It registers the preset, installs scheduler support for configured scheduled tasks, adds unit tests, and documents configuration and build commands.

Changes

Platformatic Nitro integration

Layer / File(s)	Summary
Preset registration and scheduler hook `src/presets/_types.gen.ts`, `src/presets/platformatic/preset.ts`, `src/presets/_all.gen.ts`, `test/unit/platformatic-preset.test.ts`	The preset extends `node-server`, supports Platformatic aliases, installs the scheduler module when scheduled tasks exist, and includes tests for enabled and disabled installation.
Platformatic provider documentation `docs/2.deploy/0.index.md`, `docs/2.deploy/20.providers/platformatic.md`	The deployment documentation lists Platformatic and describes aliases, scheduler configuration, task opt-in, empty schedules, and build commands.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Merge Risk: ⚪ Minimal · up to 9d45f

The PR adds the Platformatic preset and related documentation and tests without any identified merge-blocking risk. It is merge-ready after normal checks and review.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description check	✅ Passed	The description clearly explains the new Platformatic preset, scheduler behavior, documentation updates, and linked discussion.
Title check	✅ Passed	The title follows Conventional Commits and accurately describes the addition of the Platformatic preset.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files. (1 skipped: 1 unsupported.)
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

pkg-pr-new · 2026-08-24T12:16:17Z

Open in StackBlitz

npm i https://pkg.pr.new/nitro@4554

commit: 9d45f87

pi0 · 2026-09-04T08:07:48Z

+        if (Object.keys(nitro.options.scheduledTasks).length === 0) {
+          return;
+        }
+        await installModules(nitro, ["@platformatic/nitro/scheduler"]);


We need make this a built-in feature. Nitro presets do not require external dependencies.

pi0x · 2026-09-07T22:23:22Z

I rebased this onto latest main locally. The only conflict was docs/2.deploy/0.index.md, where main had recapitalised the provider names; I kept that and added Platformatic to the list. Typecheck, lint and test/unit/platformatic-preset.test.ts all pass. I could not push, so the branch here is unchanged.

@pi0's review point is still the blocker: the preset installs @platformatic/nitro/scheduler, an external package, so it is not self-contained. That needs resolving before this can land.

One thing I fixed: the docs used defineNitroConfig from nitro/config. In v3 it is import { defineConfig } from "nitro".

Note: #4025, #3970 and #3554 also add presets and touch the same generated files, so whoever lands first forces the rest to rebase.

This comment was written by an AI assistant on behalf of the Nitro maintainers. Please double-check anything that looks wrong.

p-dubovitsky requested a review from pi0 as a code owner August 24, 2026 12:14

p-dubovitsky force-pushed the platformatic-preset branch from 8eb8995 to ef950a5 Compare August 24, 2026 12:17

p-dubovitsky closed this Aug 24, 2026

p-dubovitsky deleted the platformatic-preset branch August 24, 2026 12:17

p-dubovitsky restored the platformatic-preset branch August 24, 2026 12:20

p-dubovitsky reopened this Aug 24, 2026

p-dubovitsky force-pushed the platformatic-preset branch from ef950a5 to c87b721 Compare August 24, 2026 12:28

feat(presets): add platformatic preset

9d45f87

p-dubovitsky force-pushed the platformatic-preset branch from c87b721 to 9d45f87 Compare August 24, 2026 12:48

pi0x added enhancement New feature or request preset v3 labels Sep 2, 2026

pi0 reviewed Sep 4, 2026

View reviewed changes

This was referenced Sep 7, 2026

feat: add bunny preset #4025

Open

feat: add sevalla preset #3554

Open

Navigation Menu

Uh oh!

feat(presets): add `platformatic` preset - #4554

feat(presets): add `platformatic` preset#4554
p-dubovitsky wants to merge 1 commit into
nitrojs:mainfrom
p-dubovitsky:platformatic-preset

p-dubovitsky commented Aug 24, 2026

Uh oh!

vercel Bot commented Aug 24, 2026

Uh oh!

coderabbitai Bot commented Aug 24, 2026 •

edited

Loading

Walkthrough

Changes

Uh oh!

pkg-pr-new Bot commented Aug 24, 2026 •

edited

Loading

Uh oh!

pi0 Sep 4, 2026

Uh oh!

pi0x commented Sep 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

p-dubovitsky commented Aug 24, 2026

🔗 Linked issue

❓ Type of change

📚 Description

📝 Checklist

Uh oh!

vercel Bot commented Aug 24, 2026

Uh oh!

coderabbitai Bot commented Aug 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Uh oh!

pkg-pr-new Bot commented Aug 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pi0 Sep 4, 2026

Choose a reason for hiding this comment

Uh oh!

pi0x commented Sep 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

coderabbitai Bot commented Aug 24, 2026 •

edited

Loading

pkg-pr-new Bot commented Aug 24, 2026 •

edited

Loading