Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Allow `vp staged` to resolve workspace-root config from subdirectories

Open
#2,177 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Needs clarification
Activity status
Quiet
Tech stack
typescript
Domain
cli, tooling

Research direction

Start with packages/cli/src/staged/bin.ts, then read the workspace-bounded traversal in packages/cli/src/resolve-vite-config.ts and its use in packages/cli/src/pack-bin.ts. Reproduce the root-config-from-package scenario described above, then establish and validate a single config-resolution and execution-scope policy, including the package-local Vite config edge case.

Written by the indexing model from the issue text.

Description

pending triage
Description

In a monorepo, vp staged fails when invoked from a workspace package if the staged config exists only in the workspace-root vite.config.ts.

This is common with coding agents: after inspecting or editing one package, they often keep that package as the working directory when running validation commands.

repo/
├── package.json          # workspaces: ["packages/*"]
├── vite.config.ts        # contains staged config
└── packages/
    └── app/
        └── src/index.ts
// repo/vite.config.ts
export default {
  staged: {
    '*.{js,ts,tsx}': 'vp check --fix',
  },
}
git add packages/app/src/index.ts
cd packages/app
vp staged

Actual result:

error: No "staged" config found in vite.config.ts. Please add a staged config

A normal pre-commit hook usually hides this behavior because Git starts client-side hooks from the worktree root, regardless of where git commit was entered.

Current behavior

The following was verified with an isolated Git monorepo:

Invocation Config File/task scope
Run from repository root Root vite.config.ts Repository
Run from a package with no local staged config None; exits with an error Nothing runs
Run from a package with a local staged config Package config Package CWD
Run from a package with --cwd <workspace-root> Root config Repository
Run through a Git pre-commit hook Root config, because Git uses the worktree root Repository

Internally, Vite+ resolves one staged object from the invocation CWD and passes it through lint-staged's programmatic config option. lint-staged still resolves the Git repository and staged files, but its own multi-config discovery is bypassed.

Ecosystem patterns

Existing tools use different models:

Model Tools Behavior
Hook manager Git, Husky, simple-git-hooks Git starts hooks at the worktree root. The manager executes a literal hook command; package-specific CWD or filtering is left to that command.
Central root config pre-commit, Lefthook The tool resolves the Git root and loads a repository-level config. Package behavior is expressed through filters or per-command root settings.
Distributed config lint-staged The tool can discover multiple configs, assign each staged file to its closest config, and run tasks from the selected config directory. Configs are isolated rather than merged.
Current Vite+ behavior vp staged Git state is repository-aware through lint-staged, while Vite config lookup remains limited to the invocation CWD.

Relevant details:

Design choices

There are two separate decisions. This issue does not propose a preferred combination.

1. Where should config come from?
  • Current CWD only: preserve existing behavior; improve documentation/error output and require callers to use root CWD or --cwd.
  • Workspace/Git root: always use one central root policy.
  • Nearest ancestor config: walk upward to the workspace root. This could stop at the first Vite config, or continue until finding one that defines staged.
  • Multiple configs: discover package/root staged configs and assign files to them independently.
  • Explicit selection: add an option such as --config or --root; this can supplement any implicit rule.

Important edge case: a package may have a vite.config.ts for build settings but keep staged only at the workspace root. “Nearest Vite config” and “nearest config defining staged” produce different results.

2. What should the execution scope be?
  • Repository root: task CWD, glob base, and staged-file scope all use the root.
  • Invocation directory: an inherited/root config can be used while files and tasks remain scoped to the package from which the command was launched.
  • Config directory: tasks and file matching follow whichever config was selected.

These choices have different consequences. Root scope may process staged files in sibling packages; invocation scope may run root-defined commands from a package CWD; config-directory scope becomes more complex if multiple configs are supported.

Possible combinations include:

  • root config + root scope;
  • nearest ancestor config + invocation scope;
  • current behavior + an explicit config/root option;
  • multiple configs + per-config task scope.
Relevant implementation
Validations
  • Read the Contributing Guidelines.
  • Confirm this request is for Vite+ itself and not for Vite, Vitest, tsdown, Rolldown, or Oxc.
  • Checked that there is not already an open issue requesting the same behavior.
Dominant language
Rust
Stars
5.8k
Forks
263
Avg merge
1d 4h
Merged PRs (30d)
148

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from voidzero-dev/vite-plus

All issues in voidzero-dev/vite-plus

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.