Skip to content

docs(create): explain setup when no template fits - #3456

Merged
fengmk2 merged 4 commits into
mainfrom
codex/issue-3427-create-docs
Nov 16, 2026
Merged

fengmk2 merged 4 commits into
mainfrom
codex/issue-3427-create-docs

Conversation

@fengmk2

@fengmk2 fengmk2 commented Nov 15, 2026

Copy link
Copy Markdown
Member

The creation guide does not explain the next step when no suitable template is available through vp create.

Add a short tip in docs/guide/create.md: use the framework or tool's own initializer, then follow the vp migrate guide. This connects project creation to migration where users look for templates.

Related to #3427.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 15, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://codex-issue-3427-create-docs-viteplus-dev.voidzero-docs.workers.dev (commit d1453f8)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://43658aaf-viteplus-dev.voidzero-docs.workers.dev d1453f8 2026-11-16T12:06:38.721Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://8d422049-viteplus-dev.voidzero-docs.workers.dev 11f5464 2026-11-16T05:13:53.885Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://fde4b543-viteplus-dev.voidzero-docs.workers.dev 882bdfb 2026-11-16T02:12:06.935Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://65f9a518-viteplus-dev.voidzero-docs.workers.dev bcefb22 2026-11-15T03:17:31.831Z Visit the dashboard ↗

@github-actions

github-actions Bot commented Nov 15, 2026 •

Copy link
Copy Markdown
Contributor

✅ Staging deployment successful!

Preview: https://viteplus-staging.void.app/
Commit: d1453f8

@fengmk2 fengmk2 self-assigned this Nov 15, 2026

@jong-kyung jong-kyung left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me💜

@AXT-AyaKoto AXT-AyaKoto left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thanks for adding this!

@fengmk2
fengmk2 requested a review from cpojer November 16, 2026 02:11
@fengmk2
fengmk2 merged commit 0bf07ee into main Nov 16, 2026
43 checks passed
@fengmk2
fengmk2 deleted the codex/issue-3427-create-docs branch November 16, 2026 12:17
@fengmk2 fengmk2 mentioned this pull request Nov 16, 2026
fengmk2 added a commit that referenced this pull request Nov 17, 2026
Vite+ 1.7.0 runs type-aware linting and type checking on tsrs, a Rust
port of the TypeScript 7 compiler, gives `@voidzero-dev/vite-plus-core`
a version that encodes the bundled Vite version (`8.3.8000` for Vite
`8.3.8`) so compatible `vite` plugins pass peer checks, and adds `vp
check --fix-dangerously`.

### Features

- Type-aware linting and type checking in `vp lint` and `vp check` use
[tsrs](https://github.com/oxc-project/tsrs), a Rust port of the
TypeScript 7 compiler, through its `tsrs-lint` executable. Commands and
configuration stay the same, and `tsrs` installs with `vite-plus`. In
the
[benchmark](https://github.com/voidzero-dev/vite-plus/blob/main/bench/tsrs-lint.md)
on two projects, with the same CLI and Oxlint, type-aware `vp lint` and
a full `vp check` took 18% to 53% less time with tsrs than with the
previous backend, and used about half the peak memory
([docs](https://viteplus.dev/guide/lint#type-aware-linting))
([#3352](#3352)), by
@fengmk2:
- tsrs targets TypeScript `7.1.0-beta`, so type-check diagnostics can
change.
- With `trustPolicy: no-downgrade` in `pnpm-workspace.yaml`, pnpm
rejects the bundled `tsrs` release ([upstream
issue](oxc-project/tsrs#945)). `vp migrate`
adds `tsrs@7.1.0-beta.tsrs2` to `trustPolicyExclude`, so run it if this
policy blocks the upgrade.
- `@voidzero-dev/vite-plus-core` has a version that encodes the bundled
Vite version: `8.3.8000` for Vite `8.3.8` in this release. Projects
alias `vite` to this package, so plugins whose `vite` peer range
includes the bundled Vite, such as `@vitejs/plugin-react` with `^8.0.0`,
now pass peer checks. npm no longer prints `ERESOLVE overriding peer
dependency` warnings, and npm and Bun projects that declare only
`vite-plus` install one copy of Vite for Vitest and Vite+, about 20 MiB
less in `node_modules` on macOS arm64
([#3317](#3317)), by
@fengmk2:
- On pnpm 10.2.0 and later, `vp migrate` removes the broad `vite` rule
from `peerDependencyRules`. A plugin whose `vite` peer range excludes
the bundled Vite then reports a peer warning, and with
`strictPeerDependencies` the install fails. Update that plugin, or allow
its range for that plugin only ([migration
rules](https://viteplus.dev/guide/migrate-rules#pnpm)).
- `vite-plus` and the core no longer share a version number. If you
update them by hand or with a dependency bot, read the alias with `npm
view vite-plus@1.7.0 dependencies.vite`, or run `vp migrate` to update
both
([docs](https://viteplus.dev/guide/upgrade-project#manually-updating)).
- `vp check --fix-dangerously` formats files and applies all lint fixes,
including dangerous fixes and suggestions. It does not need `--fix`, and
it works with `--no-fmt` and `--continue-on-error`. Review the changes
before you commit them, because dangerous fixes can change program
behavior ([docs](https://viteplus.dev/guide/check#usage))
([#3413](#3413)), by
@chbaefront.
- `vp create` with a third-party `create-xxx` template asks about agent
instructions, editor configs, Git, and commit hooks after the template's
own CLI finishes, and checks what that CLI generated: it offers to
append to an existing agent file, merges existing editor configs, and
asks about Git only when the template did not create a repository. When
the generated standalone project already depends on `vite-plus`, `vp
create` keeps the template's choices, such as ESLint or its `vite-plus`
version, and skips the migration. Set `VP_FORCE_MIGRATE=1` to run it
([#3424](#3424),
[#3435](#3435)), by
@liangmiQwQ.
- Upgrade the bundled Vite, Rolldown, oxc-node, Oxlint, Oxfmt, and
lint-staged
([#3436](#3436),
[#3440](#3440),
[#3452](#3452),
[#3463](#3463),
[#3470](#3470)), by
@voidzero-guard[bot] and @fengmk2:
- `vite@8.3.7` to `vite@8.3.8`. Vite rejects CSS entry points when
`build.cssCodeSplit` is `false`, imports Sass once instead of once per
file, and no longer opens a console window for `yarn config get` on
Windows.
- `rolldown@1.2.18` to `rolldown@1.2.19`. The `linux-x64-gnu` binding
runs on older CPUs.
- `oxc-node@1.0.1` to `oxc-node@1.0.2`, the loader behind `vpx` for
TypeScript files and `vite-plus/register`. TypeScript files with
`import` and `export` in a CommonJS package run as CommonJS when
tsconfig compiles them to CommonJS, `package.json` `"type"` selects the
format of `.ts` files under `module: node16` and `nodenext`, and `vpx
--watch` on macOS no longer uses more memory each time a watched folder
is replaced.
- `oxlint@1.93.0` to `oxlint@1.94.0`. Many fixes that can change program
behavior are now suggestions or dangerous fixes, so `vp check --fix`
applies fewer of them, and `vp check --fix-dangerously` applies them.
`typeCheck` is no longer experimental, and `no-misused-promises` gets a
`flagUnions` option.
- `oxfmt@0.78.0` to `oxfmt@0.79.0`. Oxfmt moves to Prettier 3.10.1 and
fixes the output for several TypeScript, Vue, Angular, HTML, Markdown,
CSS, and GraphQL cases, so formatting can change.
- `lint-staged@17.6.0` to `lint-staged@17.6.1` in `vp staged`. The
warning about hidden partially staged changes appears only when the
changes are restored.
- The new Oxfmt, Oxlint, and tsrs can flag code that passed before. If
your CI runs `vp check`, run `vp check --fix --continue-on-error` after
you upgrade: it formats files, applies the available lint fixes, formats
again, and reports every error that remains.

### Fixes & Enhancements

- `vp upgrade` no longer deletes a version directory that it did not
create when an installation fails, so `vp upgrade --rollback` still
finds the previous version after a failed reinstall. `vp upgrade`, `vp
upgrade --rollback`, and installer setup wait for each other, so two
upgrades that run at the same time can no longer leave `current`
pointing to a missing directory. `vp upgrade` also repairs an active
version whose `vp` binary is missing
([#3412](#3412)), by
@jong-kyung and @fengmk2.
- An empty `VP_NODE_SKIP_SIGNATURE_VERIFY`, `VP_NODE_DIST_MIRROR`, or
`npm_config_registry` (in either letter case) counts as unset, as in
pnpm. Before, `VP_NODE_SKIP_SIGNATURE_VERIFY=""` turned off PGP
verification of Node.js downloads, and an empty mirror or registry
failed with `relative URL without a base`
([#3444](#3444)), by
@jong-kyung.
- With a token for the default npm registry in `.npmrc`, the
package-manager shims again use cached dist-tags for a `latest` default
and fall back to the cache offline, instead of waiting on the registry
at each call and failing when it cannot be reached. Other authenticated
registries still skip the cache
([#3457](#3457)), by
@liangmiQwQ.
- `vp pack` uses `pack.envPrefix` from `vite.config.ts`. Before, the
default prefixes `VITE_PACK_` and `TSDOWN_` always replaced it, so
variables under the configured prefix were not inlined and variables
under the default prefixes were. The `--env-prefix` flag still takes
precedence
([#3454](#3454)), by
@jong-kyung.
- `vp migrate --full` on a project that the first migration left on
ESLint and Prettier no longer loses their settings. When
`vite.config.ts` holds only the default `lint` and `fmt` blocks that `vp
migrate` added, the converted settings replace them. When those blocks
have your own settings, the converted `.oxlintrc.json` or Prettier stays
in place with a warning
([#3464](#3464)), by
@jong-kyung.
- `vp migrate` writes `npmPreapprovedPackages` to `.yarnrc.yml` only for
Yarn 4.10.0 and later. Older Yarn versions do not know this key and
refused to run, so migrated Yarn 2 and 3 projects, and Yarn 4.0 to 4.9
projects whose Yarn upgrade failed, could not install
([#3443](#3443)), by
@jong-kyung.
- `vp migrate` merges the duplicate `vite-plus` imports that it creates
when it rewrites `vite` imports, so `import/no-duplicates` no longer
reports them. Comments, side-effect imports, and code between the
imports stay in place
([#3439](#3439)), by
@voidzero-bot[bot] and @fengmk2.
- A second `vp migrate` run keeps `oxlint` in the `dependencies` of a
package that publishes an Oxlint plugin, as the first run does
([#3462](#3462)), by
@jong-kyung.
- `vp migrate` warns when the root or a workspace package has
`turbo.json`, `turbo.jsonc`, or a `turbo` dependency, because `vp run`
does not read Turborepo configuration. The warning links to the task and
cache guides for manual migration
([#3300](#3300)), by
@voidzero-bot[bot] and @fengmk2.
- When `vp create` adds a third-party template to a monorepo, it
rewrites the new package's `vite` imports to `vite-plus`, so `vp check`
no longer reports `vite-plus/prefer-vite-plus-imports` errors there
([#3282](#3282)), by
@voidzero-bot[bot] and @fengmk2.
- New monorepos from `vp create` reference their dependency catalog
entries with `catalog:` and contain no unused entries, and the
TypeScript and `@types/node` catalog versions match the generated
packages ([#3393](#3393)),
by @d4rshnn.
- `vp create` works in projects pinned to Yarn 1.x: it runs templates
with `npx --yes`, as `vp dlx` does, because Yarn Classic has no `yarn
dlx` ([#3468](#3468)), by
@jong-kyung.
- `vp env exec --node` and `vp env pin` accept `lts/*`,
`lts/<codename>`, and `lts/-n`, as `vp env use` does. `vp env pin lts/*`
writes the resolved exact version
([#3437](#3437)), by
@jong-kyung.
- Ctrl+C or `SIGTERM` during a spinner in `vp create` and `vp migrate`
ends the command by that signal, so the shell reports 130 or 143 instead
of 0, as for the native spinners since 1.6.0. Escape no longer ends the
command while a spinner is visible
([#3432](#3432)), by
@jong-kyung.
- The Vitest resolver that `defineConfig` adds declares a `resolveId`
filter, so Rolldown builds skip it without a call into JavaScript for
imports other than `vitest`, `vitest/*`, `@vitest/*`, and
`vite-plus/test`. A synthetic build with 40,000 `resolveId` calls and no
other work took 1.4 s instead of 1.9 s
([#3434](#3434)), by
@jasonkuhrt.

### Docs

- Name `vp test` together with `vp build` as commands that support
cooperative tracking in the cache guide
([#3453](#3453)), by
@SaKaNa-Y.
- Explain in the create guide what to do when no template fits: run the
framework's own initializer, then follow the `vp migrate` guide
([#3456](#3456)), by
@fengmk2.

### Chore

- Update npm dependencies. New generator projects from `vp create
vite:generator` depend on `bingo@^0.16.0`
([#3392](#3392)), by
@renovate[bot].
- Update Rust dependencies, including `syn` 3 and `testing_macros` 2
([#3312](#3312),
[#3460](#3460),
[#3461](#3461)), by
@renovate[bot].
- The issue triage bot uses Conventional Commits PR titles and leaves
assigned issues to their assignees
([#3459](#3459),
[#3458](#3458)), by
@liangmiQwQ.
- Compare `User-Agent` header names case-insensitively in an HTTP test
([#3469](#3469)), by
@liangmiQwQ.
- Refine the release-manager skill from the v1.5.0, v1.5.1, and v1.6.0
releases ([#3348](#3348)),
by @fengmk2.

### Bundled Versions

| Tool | Version | Source | Changelog |
| -------- | ------------------ |
----------------------------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
| vite | `8.3.8` |
[`b39e6e6`](vitejs/vite@b39e6e6)
| [8.3.8](https://github.com/vitejs/vite/releases/tag/v8.3.8) |
| rolldown | `1.2.19` |
[`b9c75dd`](rolldown/rolldown@b9c75dd)
| [1.2.19](https://github.com/rolldown/rolldown/releases/tag/v1.2.19) |
| oxc-node | `1.0.2` |
[`16c0f34`](oxc-project/oxc-node@16c0f34)
| [1.0.2](https://github.com/oxc-project/oxc-node/releases/tag/v1.0.2) |
| tsdown | `0.23.4` | [npm](https://npmx.dev/package/tsdown/v/0.23.4) |
unchanged |
| vitest | `5.1.0` | [npm](https://npmx.dev/package/vitest/v/5.1.0) |
unchanged |
| oxlint | `1.94.0` | [npm](https://npmx.dev/package/oxlint/v/1.94.0) |
[1.94.0](https://github.com/oxc-project/oxc/releases/tag/oxlint_v1.94.0)
|
| tsrs | `7.1.0-beta.tsrs2` |
[npm](https://npmx.dev/package/tsrs/v/7.1.0-beta.tsrs2) |
[7.1.0-beta.tsrs2](https://github.com/oxc-project/tsrs/releases/tag/v7.1.0-beta.tsrs2)
(replaces oxlint-tsgolint) |
| oxfmt | `0.79.0` | [npm](https://npmx.dev/package/oxfmt/v/0.79.0) |
[0.79.0](https://github.com/oxc-project/oxc/releases/tag/oxfmt_v0.79.0)
|

### Upgrade

```bash
vp upgrade
```

In each project, run `vp migrate` to update `vite-plus`, the `vite`
alias to `@voidzero-dev/vite-plus-core@8.3.8000`, and the Vitest pin
together ([guide](https://viteplus.dev/guide/upgrade-project)).

### New Contributors

@jasonkuhrt, @d4rshnn

**Full Changelog**:
v1.6.0...v1.7.0

---

For a stable release, complete the `HomebrewFormula/vp.rb` update after
publication by merging the generated `release/homebrew-v1.7.0` PR.

Merging this PR will trigger the release workflow.

---------

Co-authored-by: voidzero-guard[bot] <278573678+voidzero-guard[bot]@users.noreply.github.com>
Co-authored-by: MK (fengmk2) <fengmk2@gmail.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants