Welcome to my Japanese cookbook

The cookbook is available at https://paginegiappe.it/

This website is built using Docusaurus, a modern static website generator.

---

Prerequisites

• Node.js 20 or 22 LTS
• npm 9+

---

Installation

Use npm. If package-lock.json is present, prefer npm ci.

# first time or on CI
npm ci

# or, if you are developing and adding deps
npm install

---

Local Development

npm start

This starts the dev server and opens a browser. Changes hot-reload automatically.

---

Build

npm run build

This generates static files into the build directory.

Optional local preview:

npm run serve

---

Deployment on Netlify

This project is deployed on Netlify.

Setup (once)

• Build command: npm run build
• Publish directory: build
• Environment:
  • NODE_VERSION = 22

You can connect the site to this GitHub repo for automatic deploys on push.

Manual deploy via CLI (optional)

npm run build
npx netlify-cli deploy --prod --dir build

You will be prompted to pick the existing site.

---

Serialize recipes for AI

To update ricettario.json:

ruby serialize_recipes.rb

To add a git hook that runs serialize_recipes.rb, install Husky:

npm install --save-dev husky
npx husky init

Then edit .husky/pre-commit and add:

ruby serialize_recipes.rb
git add ricettario.json

---

Scripts

• npm start — start local dev server
• npm run build — build static site
• npm run serve — preview the built site locally