---
title: "`tailwind.config.*` exists but the CSS entry has no `@config` (lint/tw-js-config-ignored)"
description: "lint/tw-js-config-ignored: Tailwind v4 is configured in CSS. Move the theme into `@theme { … }` in your CSS entry (preferred), or add `@config…"
canonical: https://void-design.vercel.app/rules/lint/tw-js-config-ignored
lastModified: 2026-09-16
---

# `tailwind.config.*` exists but the CSS entry has no `@config`

`lint/tw-js-config-ignored` · severity **warn** · category Lint · detected by `void lint` and `void audit`

## Why it matters

Tailwind v4 is configured in CSS. A JavaScript config is only loaded when a stylesheet references it with `@config`; otherwise its theme, plugins and `darkMode` are ignored and every class it defined produces no CSS.

## How to fix it

Move the theme into `@theme { … }` in your CSS entry (preferred), or add `@config "./tailwind.config.ts";` right after `@import "tailwindcss";`. Delete the JS file once migrated.

## Example

```css
@import "tailwindcss";
@theme {
  --color-brand: oklch(0.62 0.19 272);
  --font-display: "Inter Display", sans-serif;
}
```

## References

- https://tailwindcss.com/docs/functions-and-directives#config-directive
- https://tailwindcss.com/docs/upgrade-guide#using-a-javascript-config-file

## More lint rules

`void lint` reports 67 rules in this category. Static source checks with no browser: Tailwind v4 silent failures, Next.js 16 API traps, React render-body bugs, accessibility markup, SEO files and motion hygiene.

- `tw-unknown-class` Class looks like a Tailwind utility but compiles to no CSS — [lint/tw-unknown-class](https://void-design.vercel.app/rules/lint/tw-unknown-class)
- `tw-v3-arbitrary-var` `utility-[--var]` is Tailwind v3 syntax; v4 needs `utility-(--var)` — [lint/tw-v3-arbitrary-var](https://void-design.vercel.app/rules/lint/tw-v3-arbitrary-var)
- `tw-dark-variant-os` `dark:` follows the OS, but the app toggles themes with a class/attribute — [lint/tw-dark-variant-os](https://void-design.vercel.app/rules/lint/tw-dark-variant-os)
- `tw-v3-renamed` Utility whose meaning changed between Tailwind v3 and v4 — [lint/tw-v3-renamed](https://void-design.vercel.app/rules/lint/tw-v3-renamed)
- `tw-important-soup` Many `!important` utilities in one file — [lint/tw-important-soup](https://void-design.vercel.app/rules/lint/tw-important-soup)
- `tw-arbitrary-sprawl` Many arbitrary colors / pixel values bypass the design tokens — [lint/tw-arbitrary-sprawl](https://void-design.vercel.app/rules/lint/tw-arbitrary-sprawl)
- `page-level-use-client` `"use client"` at the top of a page or layout — [lint/page-level-use-client](https://void-design.vercel.app/rules/lint/page-level-use-client)
- `heavy-import` Heavy dependency imported into client code — [lint/heavy-import](https://void-design.vercel.app/rules/lint/heavy-import)

Detected by `void lint` and `void audit`. Explain it in a terminal: `void rules lint/tw-js-config-ignored`