Repository navigation
TypeScript 6 compatibility: import '@payloadcms/next/css' fails with TS2882 #16346
Description
Describe the Bug
TypeScript 6 enables noUncheckedSideEffectImports by default (announcement). This causes all three import '@payloadcms/next/css' statements generated by create-payload-app to fail with TS2882.
Type error: Cannot find module or type declarations for side-effect import of '@payloadcms/next/css'.
Link to the code that reproduces this issue
https://github.com/andershermansen/payload-repro-ts6-css-import
Reproduction Steps
- Create a new payload app from blank template
- Update to typescript 6.0.3
- Build
Actual:
Build fails
Expected:
Build successful
Which area(s) are affected?
area: core
Environment Info
Binaries:
Node: 24.15.0
npm: 11.12.1
Yarn: N/A
pnpm: 10.33.0
Relevant Packages:
payload: 3.83.0
next: 16.2.3
@payloadcms/db-mongodb: 3.83.0
@payloadcms/graphql: 3.83.0
@payloadcms/next/utilities: 3.83.0
@payloadcms/richtext-lexical: 3.83.0
@payloadcms/translations: 3.83.0
@payloadcms/ui/shared: 3.83.0
react: 19.2.4
react-dom: 19.2.4
Operating System:
Platform: darwin
Arch: arm64
Version: Darwin Kernel Version 25.4.0: Thu Mar 19 19:30:44 PDT 2026; root:xnu-12377.101.15~1/RELEASE_ARM64_T6000
Available memory (MB): 32768
Available CPU cores: 10
Activity
bastienrobert commentedon Apr 30, 2026
A workaround is to add a
payload-css.d.tsinsrc:fix: add type declarations for css export (TypeScript 6 compat) (#16348)
github-actions commentedon Jun 9, 2026
🚀 This is included in version v3.85.1