Plus leaves early access today, and Flow 1.0 comes with it. Over the last few months, early access members told us what made Flow useful: the knowledge base, the skills and the lint rules. Flow 1.0 keeps those, drops the spec-driven workflow and the dashboard, and adds reviews of your pull requests for problems specific to AdonisJS. Plus moves to a new app with a new account area to go with it. Thank you to each member who stayed with us through the changes.
Your tokens and .npmrc keep working, and your price stays the same while your subscription renews. Upgrading takes a few minutes. The steps are at the end of this post.
Pull request reviews
Flow reviews each pull request for problems specific to AdonisJS, with nine lenses from the team behind the framework. The review runs in your GitHub Actions on your own Claude Code or Codex, and a critical or major finding fails the check. Each push is reviewed again.
Flow reviews do not replace CodeRabbit or other general reviewers. They look only for AdonisJS problems, so you can run both. Plus sells no credits. The review uses your own subscription or API key.
The nine lenses look for:
review-access-control: an action that reads or changes another user's record, or acts on a record without an authorization check.review-response-exposure: a private value sent to the client, an error that tells too much, or a private page that a cache or the browser history keeps.review-response-design: a response that breaks the rules of theflow-response-designskill.review-cruddy-controllers: a controller or route that breaks the rules of theflow-cruddy-controllersskill.review-migration-safety: a migration that can lose data, fail on a table with rows, or lock a large table.review-input-validation: input from a request, a webhook or a job that reaches the code without a validator.review-query-cost: an N+1 query, a read of every row of a growing table, or a connection held while the code waits.review-code-placement: server code that breaks the rules of theflow-code-placementskill.review-tests: a changed behaviour with no test that proves it.
To turn on reviews, install the GitHub App from your account. See Code reviews.
Local reviews
Review your branch on your computer before you open a pull request. The command starts a session of your coding agent, with the same lenses as a review on GitHub. It works with Claude Code, Codex, Cursor and OpenCode, and needs no GitHub App.
npx @adonisplus/flow reviewSee Local reviews.
Apply a feature pack
Apply a feature pack with one command. It starts your coding agent with the flow-apply skill and the pack you name.
npx @adonisplus/flow apply --pack=passkeysSee Feature packs.
One install command
Flow is a command of its own now, npx @adonisplus/flow install, and works without the Ace commands. It writes a flow.lock, so each computer installs the same agents and docs. See Installation and setup.
Workflow skills
Flow no longer ships workflow skills. Use the workflow skills you like, for example Matt Pocock's skills or pstack, next to the Flow skills. A guide for using them with Flow is coming.
New skills
Six new skills give your agent the decisions of an AdonisJS app. Your agent finds and uses them on its own. You never invoke them.
flow-access-controlscopes each read and write to its user, tenant or organisation, and checks access to each record.flow-code-placementdecides where a helper, a service or shared code goes.flow-pattern-object-designturns a value and its loose functions into one class.flow-response-designdecides the props of a page, the transformer that makes them, and the relations to preload.flow-schema-designsettles soft deletes, money, enums, polymorphic relations and changes to tables that have rows.flow-validation-layersdecides whether a check goes in the validator, a guard or a database constraint.
See Skills.
New lint rules
Four new lint rules keep functions, private controller methods and types in their place.
no-top-level-functionsreports functions declared at the top level of a file. Behaviour lives in classes.exported-functions-are-factoriesreports exported functions, unless they arecreate…ormake…factories that return a class instance.no-private-controller-methodsreports private and protected methods on controllers.types-live-in-types-directoryreports types and interfaces declared outsidetypes/.
See Lint rules.
The new Plus app
plus.adonisjs.com has a new website and a new account area.
- Onboarding tracks your setup, step by step.
- GitHub App turns on pull request reviews.
- Feedback takes your feature requests. Accepted requests go into the build queue.
- Invites send the GitHub invite to the account you sign in with.
- Billing opens your Polar portal.
Registry sign-in
Sign in to the registry from your browser, with no token to create. npm, pnpm and Bun use:
npm login --registry=https://plus.adonisjs.com/registry/ --scope=@adonisplus --auth-type=webYarn uses:
yarn npm login --scope adonisplus --web-loginCI and deployments still need a token. See CI and deployment.
Docs
New and updated pages: Code reviews, Coding agents, Customizing, Updating Flow, Monorepos and Troubleshooting.
Upgrade with your agent
Paste this prompt into your coding agent, in the root of your project. It upgrades Flow, and asks before it deletes or commits anything.
Upgrade by hand
Remove the old entries from adonisrc.ts
Section titled "Remove the old entries from adonisrc.ts"Flow 1.0 has no Ace commands and no dashboard. Remove these two lines, or
node acefails.adonisrc.tscommands: [ () => import('@adonisplus/flow/commands'), ], providers: [ () => import('@adonisplus/flow/flow_dashboard_provider'), ],Upgrade and install
Section titled "Upgrade and install"Upgrade
@adonisplus/flow, then run the installer in the folder of your app. It replaces the files of Flow 0.5.npm i -D @adonisplus/flow@latest npx @adonisplus/flow installClean up
Section titled "Clean up"Flow 1.0 does not use
.flow/changes,.flow/states,.flow/boards,.flow/archiveor.junie/. Delete them. In a monorepo, also remove the Flow 0.5 files at the workspace root, because Flow now lives in the folder of your app. See Monorepos.Commit
Section titled "Commit"Commit
flow.lockand.flow/review.yml, with the other changes of the installer.
Breaking changes
The spec-driven workflow skills (brief, blueprint, assert, build, sync, archive) and the dashboard at /__dashboard are removed. Junie and the generic stack are no longer supported. In a monorepo, Flow installs in the folder of your app, not at the root.
