Daisuke 556408830c docs: add dependency update guidance

- document npm audit fix --force usage
- list required verification steps

2026-02-01 16:09:36 +09:00

Naputo - n-daisuke897's blog

Welcome to my blog repository!

Commands

All commands are run from the root of the project, from a terminal:

Command	Action
`npm install`	Installs dependencies
`npm run dev`	Starts local dev server at `localhost:4321`
`npm run build`	Build your production site to `./dist/`
`npm run preview`	Preview your build locally, before deploying
`npm run astro ...`	Run CLI commands like `astro add`, `astro check`
`npm run astro -- --help`	Get help using the Astro CLI

For security/deprecated remediation, allow breaking changes via npm audit fix --force, then verify:

If you use Nix, you can enter a dev shell that provides the required CLI tools for this repo:

nix develop

This is intended to provide tools like Forgejo CLI (fj) and Node.js so "when you enter the repo, everything is available":

nix develop --command fj version
nix develop --command node --version

This repo can be developed inside a Podman container to keep your host clean and improve reproducibility.

podman compose up --build

On WSL2/rootless Podman, if you hit netavark/nftables errors, this repo defaults to slirp4netns via network_mode in compose.yml.

Run other commands in the running container:

podman compose exec app npm run build
podman compose exec app npm run preview -- --host 0.0.0.0 --port 4321

If hot reload is unstable/slow, enable polling:

CHOKIDAR_USEPOLLING=1 podman compose up --build

Tip: placing the repo under the WSL filesystem (e.g. ~/project/...) is often faster than under /mnt/c.