Getting Started

Troubleshooting

Common issues and their solutions when working with Docus.

pnpm issues

Approve build scripts

If you encounter build or dev errors when using pnpm, especially related to better-sqlite3 dependency, you might need to approve certain packages for building.

Run the following command to approve packages for building:

Terminal
pnpm approve-builds

When prompted, select better-sqlite3 and sharp from the list of packages to approve it for building.

Enable shameful hoisting (compatibility mode)

If you see errors such as Can't resolve 'tailwindcss' or Can't resolve '@nuxt/ui-pro' you don't necessary need to import them, you can just apply a flat node_modules layout (like npm or yarn).

You can enable compatibility mode by creating a .npmrc file with:

.npmrc
shamefully-hoist=true