V2

Use this guide to migrate your project from Thulite v1 to Thulite v2.

Prerequisites#

• Hugo (latest extended or extended/deploy edition)
• Thulite (latest version)
• Node.js/npm (latest LTS version)

Updating#

Follow the steps below to update your project.

1. Remove currently installed dependencies to avoid version conflicts:

   npm run clean:install

   pnpm run clean:install

   yarn run clean:install

   bun run clean:install

2. Update package.json

   Replace the contents of your project’s package.json with the following template:

   // package.json
   {
     "name": "thulite-project",
     "version": "0.0.0",
     "description": "Thulite",
     "author": "Thulite",
     "license": "MIT",
     "scripts": {
       "create": "hugo new",
       "dev": "hugo server --disableFastRender --noHTTPCache",
       "format": "prettier **/** -w -c",
       "build": "hugo --minify --gc",
       "preview": "vite preview --outDir public"
     },
     "engines": {
       "node": ">=20.11.0"
     }
   }

3. Install the latest Thulite dependency in your project:

   npm install thulite@latest

   pnpm install thulite@latest

   yarn add thulite@latest

   bun install thulite@latest

4. Install the latest versions of Prettier and Vite as devDependencies:

   npm install -D prettier@latest vite@latest

   pnpm install -D prettier@latest vite@latest

   yarn add -D prettier@latest vite@latest

   bun add -D prettier@latest vite@latest

5. Optionally, install the recommended integrations in your project:

   npm install @thulite/images@latest @thulite/seo@latest

   pnpm install @thulite/images@latest @thulite/seo@latest

   yarn add @thulite/images@latest @thulite/seo@latest

   bun install @thulite/images@latest @thulite/seo@latest

Configuration#

Review your project configuration for Thulite and the recommended integrations:

• Thulite
• Images
• SEO
• SVG

Known Issues#

ENOENT#

If you get an ENOENT error, run the following command:

npm run clean:install && npm install

pnpm run clean:install && pnpm install

yarn run clean:install && yarn install

bun run clean:install && bun install