# @tutti-os/workspace-user-project

> Reusable user-project contracts, path-label helpers, and optional React UI for workspace surfaces that need to select an execution directory or recently used project.

Latest version **0.0.427** (published 2026-08-28) · 3.3K weekly downloads

## Install

```sh
npm install @tutti-os/workspace-user-project
pnpm add @tutti-os/workspace-user-project
yarn add @tutti-os/workspace-user-project
bun add @tutti-os/workspace-user-project
```

## Health

**Score 85/100 (A)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; growing popularity.

Warnings: pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.0.427 |
| Published | 2026-08-28 |
| First published | 2026-06-11 |
| Weekly downloads | 3.3K |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 3 |
| Unpacked size | 144.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 3846 |
| Maintainers | hugozhou0638, jomeswang, vorshen, rv4no, jacksooon.0113 |

## Links

- npm: https://www.npmjs.com/package/@tutti-os/workspace-user-project
- Repository: https://github.com/tutti-os/tutti
- Homepage: https://github.com/tutti-os/tutti#readme
- Issues: https://github.com/tutti-os/tutti/issues
- npm.io page: https://npm.io/package/@tutti-os/workspace-user-project

## Dependencies (3)

- [valtio](https://npm.io/package/valtio.md) ^2.3.2
- [@tutti-os/ui-system](https://npm.io/package/@tutti-os/ui-system.md) 0.0.427
- [@tutti-os/ui-i18n-runtime](https://npm.io/package/@tutti-os/ui-i18n-runtime.md) 0.0.427

## Recent versions

- 0.0.427 (latest) — 2026-08-28
- 0.1.1-beta-20260617071210 (beta) — 2026-06-17
- 0.0.426 — 2026-08-27
- 0.0.425 — 2026-08-26
- 0.0.424 — 2026-08-26
- 0.0.423 — 2026-08-26
- 0.0.422 — 2026-08-26
- 0.0.421 — 2026-08-25
- 0.0.420 — 2026-08-25
- 0.0.419 — 2026-08-24
- 0.0.418 — 2026-08-24
- 0.0.417 — 2026-08-24
- 0.0.416 — 2026-08-24
- 0.0.415 — 2026-08-24
- 0.0.414 — 2026-08-23
- … 413 more at https://npm.io/package/@tutti-os/workspace-user-project/versions

## README

# @tutti-os/workspace-user-project

Reusable user-project contracts, path-label helpers, and optional React UI for
workspace surfaces that need to select an execution directory or recently used
project.

Hosts provide concrete project persistence, directory dialogs, and project
creation through package contracts. Daemon transport, desktop preload calls, and
host absolute-path ownership stay in the consuming host adapter.

UI copy is provided by the package i18n resources. Hosts can merge
`workspaceUserProjectI18nResources` into their app runtime and pass
`createWorkspaceUserProjectI18nRuntime(runtime)` to shared UI; `labels` are only
for explicit, narrow business overrides.

`WorkspaceUserProjectSelect` also accepts optional `menuActions`,
`showKnownProjectOptions`, and label overrides. Hosts may expose an optional
`importDirectory` operation for a Host-owned import flow. Omitting these inputs
preserves the package's existing action order, known-project rows, copy, and
directory-selection behavior.

---
_Source: https://npm.io/package/@tutti-os/workspace-user-project · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._