Module not found: Error: Can't resolve '@site/src/components/HomepageFeatures' in '/home/runner/work/<user>/<repo>/docs/src/pages'

[jcubic]

I just setup a new Docusaurus website, I didn't change anything. And I just copied build yaml file from my other project that use Docusaurus 3.2.0, but the build fail on npm run build.

This is the error I've got from GitHub:

[success] [webpackbar] Server: Compiled with some errors in [9](https://github.com/jcubic/jquery.terminal-docs/actions/runs/10763851728/job/29845868615#step:6:10).41s
[success] [webpackbar] Client: Compiled with some errors in 15.[10](https://github.com/jcubic/jquery.terminal-docs/actions/runs/10763851728/job/29845868615#step:6:11)s
Error:  Client bundle compiled with errors therefore further build is impossible.
Module not found: Error: Can't resolve '@site/src/components/HomepageFeatures' in '/home/runner/work/jquery.terminal-docs/jquery.terminal-docs/docs/src/pages'
Error: Process completed with exit code 1.

Any clue what may be the issue? I've found that @site is imported in as siteDir in webpack/base.ts#L153, but I'm not able to find it in docs, it only appears in CLI.

This is a work repo: https://github.com/jcubic/jquery.terminal-docs

You can call this a minimal example, the only files that matter in the repo are:

Workflow:

Expand

name: build docs
run-name: ${{ github.actor }} building documentation 🚀
on:
  push:
    paths:
      - "docs/**"
      - ".github/workflows/docs.yaml"
    branches:
      - docusaurus
      - master
permissions:

contents: write
concurrency:

group: ci-${{ github.ref }}

cancel-in-progress: true
defaults:

run:

working-directory: docs
jobs:

deploy:

name: Build Docusaurus

runs-on: ubuntu-latest

steps:

- uses: actions/checkout@v4

- uses: actions/setup-node@v4

with:

node-version: 20

cache: npm

cache-dependency-path: docs/package-lock.json
  - name: Install dependencies
    run: npm ci

  - name: create version file
    run: npm run version

  - name: Build website
    run: npm run build

  - name: Deploy to GitHub Pages
    uses: peaceiris/actions-gh-pages@v3
    if: ${{ github.repository == 'jcubic/jquery.terminal-docs' || (github.repository == 'jcubic/jquery.terminal' && github.ref_name == 'master')}}
    with:
      github_token: ${{ secrets.GITHUB_TOKEN }}
      publish_dir: ./docs/build
      user_name: github-actions[bot]
      user_email: 41898282+github-actions[bot]@users.noreply.github.com

and docs directory with a starter project, where I only changed the URL, in hope it will fix the issue.

[jcubic]

It was my mistake, ChatGPT suggested to check .gitignore I had components there. Probably from some old files that should be ignored.