{"id":42253,"library":"vite-plugin-vinext-payload","title":"Vite Plugin Vinext Payload","description":"Vite plugin for running Payload CMS (v3.82+) on Cloudflare Workers via vinext, a Vite-based Next.js reimplementation. Current version 0.0.19, experimental. Provides two modes: payloadPlugin() for full Payload with admin UI and REST/GraphQL (requires vinext), and payloadWorkerPlugin() for headless Payload exposing Local API via WorkerEntrypoint RPC (no admin UI, works with any Vite frontend). Key differentiator: enables Payload deployments on Cloudflare Workers with RSC support, reducing cold starts and edge latency. Requires Node >=24, Vite ^8.0.0 (Rolldown). Peer deps pinned to validated stack (Payload 3.84.1, vinext 0.0.50). Includes migration tooling from Next.js and Cloudflare D1 support. Actively developed by Block65.","status":"active","version":"0.0.19","language":"javascript","source_language":"en","source_url":"https://github.com/block65/vite-plugin-vinext-payload","tags":["javascript","vite","vite-plugin","vinext","payload","payloadcms","payload-cms","cloudflare","cloudflare-workers"],"install":[{"cmd":"npm install vite-plugin-vinext-payload","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-vinext-payload","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-vinext-payload","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Payload CMS runtime required (peer dependency >=3.82.0)","package":"payload","optional":false},{"reason":"Required for full Payload with admin UI (payloadPlugin)","package":"vinext","optional":true},{"reason":"Vite build tool (peer dependency ^8.0.0)","package":"vite","optional":false}],"imports":[{"note":"Named export, not default. ESM-only.","wrong":"import payloadPlugin from 'vite-plugin-vinext-payload'","symbol":"payloadPlugin","correct":"import { payloadPlugin } from 'vite-plugin-vinext-payload'"},{"note":"ESM-only, no CommonJS support. Named export.","wrong":"const { payloadWorkerPlugin } = require('vite-plugin-vinext-payload')","symbol":"payloadWorkerPlugin","correct":"import { payloadWorkerPlugin } from 'vite-plugin-vinext-payload'"},{"note":"CLI command, not an npm script. Must be run via npx or after installing the package.","wrong":"npm run init","symbol":"init command","correct":"npx vite-plugin-vinext-payload init"}],"quickstart":{"code":"// vite.config.ts\nimport { defineConfig } from \"vite\";\nimport vinext from \"vinext\";\nimport { payloadPlugin } from \"vite-plugin-vinext-payload\";\n\nexport default defineConfig({\n  plugins: [vinext(), payloadPlugin()],\n});","lang":"typescript","description":"Basic setup for Payload CMS with full admin UI on Cloudflare Workers using vinext."},"warnings":[{"fix":"Upgrade Node to v24 or later.","message":"Requires Node >=24. Older Node versions will fail to install or run.","severity":"breaking","affected_versions":"<24"},{"fix":"Update Vite to ^8.0.0, or use --legacy-peer-deps (not recommended).","message":"Vite ^8.0.0 required (Rolldown). Vite 5 or 6 will cause peer dependency conflicts.","severity":"breaking","affected_versions":"<8"},{"fix":"Update Payload CMS to v3.82 or later.","message":"Payload CMS must be >=3.82.0. Older versions are incompatible.","severity":"breaking","affected_versions":"<3.82"},{"fix":"Pin to exact version and monitor releases.","message":"Plugin is experimental; APIs may change without major version bump.","severity":"deprecated","affected_versions":"0.x"},{"fix":"Run `npm install -D vinext vite` and add vinext() to the Vite config.","message":"When using payloadPlugin(), vinext must be installed and configured. Missing vinext will cause build errors.","severity":"gotcha","affected_versions":"all"},{"fix":"Run `npx vite-plugin-vinext-payload init --dry-run` to preview changes.","message":"The init command is idempotent but may overwrite manual changes in vite.config.ts. Use --dry-run first.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'0.0.19':25 '0.0.50':92 '24':79 '3.84.1':90 '8.0.0':81 'activ':102 'admin':35,53 'api':48 'base':20 'block65':105 'cloudflar':13,66,99,117,119 'cloudflare-work':118 'cms':10,116 'cold':72 'current':23 'd1':100 'dep':84 'deploy':64 'develop':103 'differenti':61 'edg':75 'enabl':62 'experiment':26 'expos':46 'frontend':59 'full':32 'headless':44 'includ':93 'javascript':106 'key':60 'latenc':76 'local':47 'migrat':94 'mode':29 'next.js':21,97 'node':78 'payload':4,9,33,45,63,89,112,115 'payload-cm':114 'payloadcm':113 'payloadplugin':30 'payloadworkerplugin':42 'peer':83 'pin':85 'plugin':2,6,110 'provid':27 'reduc':71 'reimplement':22 'requir':39,77 'rest/graphql':38 'rolldown':82 'rpc':51 'rsc':69 'run':8 'stack':88 'start':73 'support':70,101 'tool':95 'two':28 'ui':36,54 'v3.82':11 'valid':87 'version':24 'via':15,49 'vinext':3,16,40,91,111 'vite':1,5,19,58,80,107,109 'vite-bas':18 'vite-plugin':108 'work':55 'worker':14,67,120 'workerentrypoint':50","created_at":"2026-06-04T18:56:22.010653+00:00","updated_at":"2026-06-04T18:56:22.010653+00:00","problems":[{"fix":"Install vinext: npm install -D vinext","cause":"Missing vinext dependency when using payloadPlugin()","error":"Error: Cannot find module 'vinext'"},{"fix":"Use --legacy-peer-deps during install, or align versions manually.","cause":"Peer dependency version conflicts with Payload or vinext","error":"ERR_PNPM_PEER_DEP_MISMATCH"},{"fix":"Upgrade Node to v24 or later.","cause":"Node version below 24","error":"The current node version is not supported"},{"fix":"Use import { payloadPlugin } from 'vite-plugin-vinext-payload'","cause":"Wrong import style used (default import instead of named import)","error":"TypeError: payloadPlugin is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/block65/vite-plugin-vinext-payload#readme","github":"https://github.com/block65/vite-plugin-vinext-payload","docs":null,"changelog":null,"pypi":null,"npm":"vite-plugin-vinext-payload","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-04","next_check":"2026-09-02","install_tag":null}}