前提条件

• Node.js(推奨バージョンの.nvmrcを参照)

はじめる

まず、依存関係をインストールし、開発サーバーを実行します。

ブラウザで[http://localhost:3000]を開き、結果を表示します。

依存性インストールスクリプト

npm 11.16+ は、依存性ライフサイクルスクリプト ([preinstall]) / [[install]])の後ろにある [[allowScripts]]フィールドの[[package.json]]をゲートします。npm 11は、未承認スクリプトについて警告しますが、npm 12はそれらをスキップします。 リストされているパッケージは、プロジェクトが常にインストールされている方法と一致する名前(任意のバージョン)によって承認されます。 [[[cypress]]は、Cypressバイナリをダウンロードするためのスクリプトを必要とします。 [@sentry/cli]スクリプトは、ビルド済みのプラットフォームパッケージが欠落しているときにのみ動作するフォールバックです。 [[[browser-tabs-lock]]は、メッセージのみを印刷します。 npm install-scripts pruneを実行して、依存ツリーを残したパッケージのエントリをドロップします。 インストールスクリプトを持つ新しい依存関係はまだフラグが付けられています(npm 11 warns、npm 12 はそれをスキップし、インストールが壊れる可能性があります)。 [npm install-scripts ls]でそれを見直し、正当な場合は、[npm install-scripts approve --no-allow-scripts-pin]で追加します。

環境変数

Pubky web app

Prerequisites

• Node.js (see .nvmrc for the recommended version)

Getting Started

First, install the dependencies and run the development server:

npm install
npm run dev

Open http://localhost:3000 with your browser to see the result.

Dependency install scripts

npm 11.16+ gates dependency lifecycle scripts (preinstall / install / postinstall) behind the allowScripts field in package.json: npm 11 warns about unapproved scripts but still runs them, npm 12 skips them. The packages listed there are approved by name (any version), which matches how the project has always installed. cypress needs its script to download the Cypress binary; the @sentry/cli script is a fallback that only does work when its prebuilt platform package is missing; browser-tabs-lock only prints a message. Run npm install-scripts prune to drop entries for packages that have left the dependency tree. Any new dependency with an install script is still flagged (npm 11 warns, npm 12 skips it and the install may break); review it with npm install-scripts ls and, if it is legitimate, add it with npm install-scripts approve --no-allow-scripts-pin.

Environment Variables

Copy the example environment file and adjust the values as needed:

cp .env.example .env

See docs/environment.md for more details.

Common Workflows

• Check architecture and coding conventions: docs/README.md
• AI-assisted development (Claude Code, Codex, Cursor): start at AGENTS.md; local review skill /pubky-code-review (.agents/skills/pubky-code-review/SKILL.md)
• Follow commit message format: docs/commit-message.md
• Cut a production release: docs/release.md
• Cut a production hotfix: docs/hotfix.md

License

This project is licensed under the MIT License.
See the LICENSE file for more details.