chore: make it easier to get started

README.md

···
 
 ## Features
 
-- **Dark mode by default** - Easy on the eyes, no toggle needed
-- **Package browsing** - Fast search, package details, READMEs, versions, dependencies
-- **Dependencies view** - Shows regular dependencies and peer dependencies (with optional badges)
-- **User profiles** - View any npm user's public packages at `/~username`
-- **Organization pages** - Browse org packages at `/org/orgname`
-- **Provenance indicators** - Verified build indicators for packages with npm provenance
-- **Admin features** - Org/team management, package access controls via local connector
+- **Dark mode by default** - easier on the eyes
+- **Package browsing** - fast search, package details, READMEs, versions, dependencies
+- **User profiles** - view any npm user's public packages at `/~username`
+- **Organization pages** - browse org packages at `/org/orgname`
+- **Provenance indicators** - verified build indicators for packages with npm provenance
+- **Admin features** - org/team management, package access controls via local connector (coming soon)
 
 ### URL Compatibility
 
···
 | `/~<username>` | [`/~sindresorhus`](https://npmx.dev/~sindresorhus) |
 | `/org/<name>` | [`/org/nuxt`](https://npmx.dev/org/nuxt) |
 
-**Coming soon** (with local connector): `/package/<name>/access`, `/package/<name>/collaborators`, `/settings/*`
-
 ## Tech Stack
 
-- [Nuxt 4](https://nuxt.com/) - Vue framework
-- [Nitro](https://nuxt.com/docs/guide/concepts/server-engine) - Server engine with API routes
-- [UnoCSS](https://unocss.dev/) - Atomic CSS engine
-- [nuxt-og-image](https://github.com/nuxt-modules/og-image) - Dynamic OG images
-- [npm Registry API](https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md) - Package data
+- [Nuxt 4](https://nuxt.com/)
+- [Nitro](https://nuxt.com/docs/guide/concepts/server-engine)
+- [UnoCSS](https://unocss.dev/)
+- [nuxt-og-image](https://github.com/nuxt-modules/og-image)
+- [npm Registry API](https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md)
 
 ## Try it out locally
 
···
 # type check
 pnpm test:types
 ```
+
+### Local Connector (CLI)
+
+The `cli/` workspace contains a local connector that enables authenticated npm operations from the web UI. It runs on your machine and uses your existing npm credentials.
+
+```bash
+# run the connector in dev mode
+pnpm --filter @npmx/connector dev
+
+# or build and run the production version
+pnpm --filter @npmx/connector build
+node cli/dist/cli.mjs
+```
+
+The connector will check your npm authentication, generate a connection token, and listen for requests from npmx.dev.
 
 ## License
 

cli/package.json

···
   ],
   "scripts": {
     "build": "unbuild",
-    "dev": "tsx src/cli.ts",
-    "typecheck": "tsc --noEmit"
+    "dev": "node --experimental-strip-types src/cli.ts",
+    "test:types": "tsc --noEmit"
   },
   "dependencies": {
     "@clack/prompts": "1.0.0-alpha.9",
···
     "picocolors": "^1.1.1"
   },
   "devDependencies": {
-    "@types/node": "^25.0.10",
-    "tsx": "^4.21.0",
+    "@types/node": "^24.10.9",
     "typescript": "^5.9.3",
     "unbuild": "^3.6.1"
   }

cli/src/cli.ts

···
 import { defineCommand, runMain } from 'citty'
 import { listen } from 'listhen'
 import { toNodeListener } from 'h3'
-import { createConnectorApp, generateToken, CONNECTOR_VERSION } from './server'
-import { getNpmUser } from './npm-client'
-import { initLogger, showToken, logInfo, showAuthRequired } from './logger'
+import { createConnectorApp, generateToken, CONNECTOR_VERSION } from './server.ts'
+import { getNpmUser } from './npm-client.ts'
+import { initLogger, showToken, logInfo, showAuthRequired } from './logger.ts'
 
 const DEFAULT_PORT = 31415
 

cli/src/index.ts

···
-export * from './types'
-export { createConnectorApp, generateToken } from './server'
+export * from './types.ts'
+export { createConnectorApp, generateToken } from './server.ts'

cli/src/npm-client.ts

···
 import { exec } from 'node:child_process'
 import { promisify } from 'node:util'
-import { logCommand, logSuccess, logError } from './logger'
+import { logCommand, logSuccess, logError } from './logger.ts'
 
 const execAsync = promisify(exec)
 

cli/src/server.ts

···
   PendingOperation,
   OperationType,
   ApiResponse,
-} from './types'
+} from './types.ts'
 import {
   getNpmUser,
   orgAddUser,
···
   ownerAdd,
   ownerRemove,
   type NpmExecResult,
-} from './npm-client'
+} from './npm-client.ts'
 
 // Read version from package.json
 const __dirname = dirname(fileURLToPath(import.meta.url))

cli/tsconfig.json

···
 {
   "compilerOptions": {
     "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
+    "module": "nodenext",
     "strict": true,
     "esModuleInterop": true,
     "skipLibCheck": true,
-    "outDir": "dist",
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
     "declaration": true,
     "declarationMap": true
   },
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules", "dist"]
+  "include": [
+    "src/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
 }

pnpm-lock.yaml

···
         version: 1.1.1
     devDependencies:
       '@types/node':
-        specifier: ^25.0.10
-        version: 25.0.10
-      tsx:
-        specifier: ^4.21.0
-        version: 4.21.0
+        specifier: ^24.10.9
+        version: 24.10.9
       typescript:
         specifier: ^5.9.3
         version: 5.9.3
···
     resolution: {integrity: sha512-laqfmMcWWNV1FsVmm1+RQUoGY8NIJvCRl0z0K8ikqPukoEry0LXMqlQ+xaf8xJRvoH2/78OhZmsEEsUBTXipcw==}
     engines: {node: '>=18.12.0'}
 
-  '@nuxt/kit@4.2.2':
-    resolution: {integrity: sha512-ZAgYBrPz/yhVgDznBNdQj2vhmOp31haJbO0I0iah/P9atw+OHH7NJLUZ3PK+LOz/0fblKTN1XJVSi8YQ1TQ0KA==}
-    engines: {node: '>=18.12.0'}
-
   '@nuxt/kit@4.3.0':
     resolution: {integrity: sha512-cD/0UU9RQmlnTbmyJTDyzN8f6CzpziDLv3tFQCnwl0Aoxt3KmFu4k/XA4Sogxqj7jJ/3cdX1kL+Lnsh34sxcQQ==}
     engines: {node: '>=18.12.0'}
···
 
   '@types/mdast@4.0.4':
     resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==}
+
+  '@types/node@24.10.9':
+    resolution: {integrity: sha512-ne4A0IpG3+2ETuREInjPNhUGis1SFjv1d5asp8MzEAGtOZeTeHVDOYqOgqfhvseqg/iXty2hjBf1zAOb7RNiNw==}
 
   '@types/node@25.0.10':
     resolution: {integrity: sha512-zWW5KPngR/yvakJgGOmZ5vTBemDoSqF3AcV/LrO5u5wTWyEAVVh+IT39G4gtyAkh3CtTZs8aX/yRM82OfzHJRg==}
···
 
   '@nuxt/devtools-kit@3.1.1(magicast@0.5.1)(vite@7.3.1(@types/node@25.0.10)(jiti@2.6.1)(lightningcss@1.31.1)(terser@5.46.0)(tsx@4.21.0)(yaml@2.8.2))':
     dependencies:
-      '@nuxt/kit': 4.2.2(magicast@0.5.1)
+      '@nuxt/kit': 4.3.0(magicast@0.5.1)
       execa: 8.0.1
       vite: 7.3.1(@types/node@25.0.10)(jiti@2.6.1)(lightningcss@1.31.1)(terser@5.46.0)(tsx@4.21.0)(yaml@2.8.2)
     transitivePeerDependencies:
···
       '@nuxt/devtools-kit': 3.1.1(magicast@0.5.1)(vite@7.3.1(@types/node@25.0.10)(jiti@2.6.1)(lightningcss@1.31.1)(terser@5.46.0)(tsx@4.21.0)(yaml@2.8.2))
       '@nuxt/eslint-config': 1.12.1(@typescript-eslint/utils@8.53.1(eslint@9.39.2(jiti@2.6.1))(typescript@5.9.3))(@vue/compiler-sfc@3.5.27)(eslint@9.39.2(jiti@2.6.1))(typescript@5.9.3)
       '@nuxt/eslint-plugin': 1.12.1(eslint@9.39.2(jiti@2.6.1))(typescript@5.9.3)
-      '@nuxt/kit': 4.2.2(magicast@0.5.1)
+      '@nuxt/kit': 4.3.0(magicast@0.5.1)
       chokidar: 5.0.0
       eslint: 9.39.2(jiti@2.6.1)
       eslint-flat-config-utils: 2.1.4
···
   '@nuxt/fonts@0.13.0(db0@0.3.4)(ioredis@5.9.2)(magicast@0.5.1)(vite@7.3.1(@types/node@25.0.10)(jiti@2.6.1)(lightningcss@1.31.1)(terser@5.46.0)(tsx@4.21.0)(yaml@2.8.2))':
     dependencies:
       '@nuxt/devtools-kit': 3.1.1(magicast@0.5.1)(vite@7.3.1(@types/node@25.0.10)(jiti@2.6.1)(lightningcss@1.31.1)(terser@5.46.0)(tsx@4.21.0)(yaml@2.8.2))
-      '@nuxt/kit': 4.2.2(magicast@0.5.1)
+      '@nuxt/kit': 4.3.0(magicast@0.5.1)
       consola: 3.4.2
       css-tree: 3.1.0
       defu: 6.1.4
···
     transitivePeerDependencies:
       - magicast
 
-  '@nuxt/kit@4.2.2(magicast@0.5.1)':
-    dependencies:
-      c12: 3.3.3(magicast@0.5.1)
-      consola: 3.4.2
-      defu: 6.1.4
-      destr: 2.0.5
-      errx: 0.1.0
-      exsolve: 1.0.8
-      ignore: 7.0.5
-      jiti: 2.6.1
-      klona: 2.0.6
-      mlly: 1.8.0
-      ohash: 2.0.11
-      pathe: 2.0.3
-      pkg-types: 2.3.0
-      rc9: 2.1.2
-      scule: 1.3.0
-      semver: 7.7.3
-      tinyglobby: 0.2.15
-      ufo: 1.6.3
-      unctx: 2.5.0
-      untyped: 2.0.0
-    transitivePeerDependencies:
-      - magicast
-
   '@nuxt/kit@4.3.0(magicast@0.5.1)':
     dependencies:
       c12: 3.3.3(magicast@0.5.1)
···
 
   '@nuxt/scripts@0.13.2(@unhead/vue@2.1.2(vue@3.5.27(typescript@5.9.3)))(db0@0.3.4)(ioredis@5.9.2)(magicast@0.5.1)(typescript@5.9.3)(vue@3.5.27(typescript@5.9.3))':
     dependencies:
-      '@nuxt/kit': 4.2.2(magicast@0.5.1)
+      '@nuxt/kit': 4.3.0(magicast@0.5.1)
       '@unhead/vue': 2.1.2(vue@3.5.27(typescript@5.9.3))
       '@vueuse/core': 14.1.0(vue@3.5.27(typescript@5.9.3))
       consola: 3.4.2
···
   '@types/mdast@4.0.4':
     dependencies:
       '@types/unist': 3.0.3
+
+  '@types/node@24.10.9':
+    dependencies:
+      undici-types: 7.16.0
 
   '@types/node@25.0.10':
     dependencies:
       undici-types: 7.16.0
+    optional: true
 
   '@types/parse-path@7.1.0':
     dependencies:
···
 
   '@types/ws@8.18.1':
     dependencies:
-      '@types/node': 25.0.10
+      '@types/node': 24.10.9
 
   '@typescript-eslint/eslint-plugin@8.53.1(@typescript-eslint/parser@8.53.1(eslint@9.39.2(jiti@2.6.1))(typescript@5.9.3))(eslint@9.39.2(jiti@2.6.1))(typescript@5.9.3)':
     dependencies:
···
 
   '@unocss/nuxt@66.6.0(magicast@0.5.1)(postcss@8.5.6)(vite@7.3.1(@types/node@25.0.10)(jiti@2.6.1)(lightningcss@1.31.1)(terser@5.46.0)(tsx@4.21.0)(yaml@2.8.2))(webpack@5.104.1(esbuild@0.27.2))':
     dependencies:
-      '@nuxt/kit': 4.2.2(magicast@0.5.1)
+      '@nuxt/kit': 4.3.0(magicast@0.5.1)
       '@unocss/config': 66.6.0
       '@unocss/core': 66.6.0
       '@unocss/preset-attributify': 66.6.0
···
 
   chrome-launcher@1.2.1:
     dependencies:
-      '@types/node': 25.0.10
+      '@types/node': 24.10.9
       escape-string-regexp: 4.0.0
       is-wsl: 2.2.0
       lighthouse-logger: 2.0.2
···
 
   happy-dom@20.3.5:
     dependencies:
-      '@types/node': 25.0.10
+      '@types/node': 24.10.9
       '@types/whatwg-mimetype': 3.0.2
       '@types/ws': 8.18.1
       entities: 4.5.0
···
 
   jest-worker@27.5.1:
     dependencies:
-      '@types/node': 25.0.10
+      '@types/node': 24.10.9
       merge-stream: 2.0.0
       supports-color: 8.1.1
 
···
   nuxt-og-image@5.1.13(@unhead/vue@2.1.2(vue@3.5.27(typescript@5.9.3)))(magicast@0.5.1)(unstorage@1.17.4(db0@0.3.4)(ioredis@5.9.2))(vite@7.3.1(@types/node@25.0.10)(jiti@2.6.1)(lightningcss@1.31.1)(terser@5.46.0)(tsx@4.21.0)(yaml@2.8.2))(vue@3.5.27(typescript@5.9.3)):
     dependencies:
       '@nuxt/devtools-kit': 3.1.1(magicast@0.5.1)(vite@7.3.1(@types/node@25.0.10)(jiti@2.6.1)(lightningcss@1.31.1)(terser@5.46.0)(tsx@4.21.0)(yaml@2.8.2))
-      '@nuxt/kit': 4.2.2(magicast@0.5.1)
+      '@nuxt/kit': 4.3.0(magicast@0.5.1)
       '@resvg/resvg-js': 2.6.2
       '@resvg/resvg-wasm': 2.6.2
       '@unhead/vue': 2.1.2(vue@3.5.27(typescript@5.9.3))
···
 
   nuxt-site-config@3.2.18(magicast@0.5.1)(vue@3.5.27(typescript@5.9.3)):
     dependencies:
-      '@nuxt/kit': 4.2.2(magicast@0.5.1)
+      '@nuxt/kit': 4.3.0(magicast@0.5.1)
       h3: 1.15.5
       nuxt-site-config-kit: 3.2.18(magicast@0.5.1)(vue@3.5.27(typescript@5.9.3))
       pathe: 2.0.3
···
       get-tsconfig: 4.13.0
     optionalDependencies:
       fsevents: 2.3.3
+    optional: true
 
   type-check@0.4.0:
     dependencies: