UI: Make @source in global.css optional

This commit is contained in:
Fuma Nama
2025-04-18 08:53:08 +08:00
parent 4fad539f77
commit a673ef4e69
15 changed files with 9 additions and 49 deletions
+5
View File
@@ -0,0 +1,5 @@
---
'fumadocs-ui': patch
---
Make `@source` in `global.css` optional
-1
View File
@@ -6,7 +6,6 @@
@source ".";
@source "../components";
@source "../content";
@source '../node_modules/fumadocs-ui/dist/**/*.js';
@source '../node_modules/fumadocs-openapi/dist/**/*.js';
@plugin 'tailwindcss-animate';
@@ -23,7 +23,6 @@ Add the package to `@source` in your Tailwind CSS configuration.
@import 'fumadocs-ui/css/neutral.css';
@import 'fumadocs-ui/css/preset.css';
@source '../node_modules/fumadocs-ui/dist/**/*.js';
/* [!code highlight] */
@source '../node_modules/fumadocs-openapi/dist/**/*.js';
```
-20
View File
@@ -164,26 +164,6 @@ See [Customisation Guide](/docs/ui/customisation).
Some common questions you may encounter.
<Accordions>
<Accordion id='fix-monorepo-styling' title="How to fix stylings not being applied in Monorepo?">
Sometimes, `fumadocs-ui` is not installed in the workspace of your Tailwind CSS configuration file. (e.g. a monorepo setup).
You have to ensure the `fumadocs-ui` package is scanned by Tailwind CSS, and give a correct relative path to `@source`.
For example, add `../../` to point to the `node_modules` folder in root workspace.
```css
@import 'tailwindcss';
@import 'fumadocs-ui/css/neutral.css';
@import 'fumadocs-ui/css/preset.css';
/* [!code --] */
@source '../node_modules/fumadocs-ui/dist/**/*.js';
/* [!code ++] */
@source '../../../node_modules/fumadocs-ui/dist/**/*.js';
```
</Accordion>
<Accordion id='change-base-url' title="How to change the base route of /docs?">
You can change the base route of docs (e.g. from `/docs/page` to `/info/page`).
@@ -64,9 +64,6 @@ Setup Tailwind CSS v4 on your Next.js app, add the following to `global.css`.
@import 'tailwindcss';
@import 'fumadocs-ui/css/neutral.css';
@import 'fumadocs-ui/css/preset.css';
/* path of `fumadocs-ui` relative to the CSS file */
@source '../node_modules/fumadocs-ui/dist/**/*.js';
```
> It doesn't come with a default font, you may choose one from `next/font`.
+1 -4
View File
@@ -5,15 +5,12 @@ description: Add Theme to Fumadocs UI
## Usage
Note only Tailwind CSS v4 is supported:
Only Tailwind CSS v4 is supported, the preset will also include source to Fumadocs UI itself:
```css title="Tailwind CSS"
@import 'tailwindcss';
@import 'fumadocs-ui/css/neutral.css';
@import 'fumadocs-ui/css/preset.css';
/* path of `fumadocs-ui` relative to the CSS file */
@source '../node_modules/fumadocs-ui/dist/**/*.js';
```
### Preflight Changes
-1
View File
@@ -3,7 +3,6 @@
@import 'fumadocs-ui/css/preset.css';
@import 'fumadocs-python/preset.css';
@source '../node_modules/fumadocs-ui/dist/**/*.js';
@source '../node_modules/fumadocs-openapi/dist/**/*.js';
:root {
-3
View File
@@ -1,6 +1,3 @@
@import 'tailwindcss';
@import 'fumadocs-ui/css/neutral.css';
@import 'fumadocs-ui/css/preset.css';
/* path of `fumadocs-ui` relative to the CSS file */
@source '../node_modules/fumadocs-ui/dist/**/*.js';
-3
View File
@@ -1,6 +1,3 @@
@import 'tailwindcss';
@import 'fumadocs-ui/css/neutral.css';
@import 'fumadocs-ui/css/preset.css';
/* path of `fumadocs-ui` relative to the CSS file */
@source '../node_modules/fumadocs-ui/dist/**/*.js';
@@ -1,5 +1,3 @@
@import 'tailwindcss';
@import 'fumadocs-ui/css/neutral.css';
@import 'fumadocs-ui/css/preset.css';
@source '../node_modules/fumadocs-ui/dist/**/*.js';
@@ -1,6 +1,3 @@
@import 'tailwindcss';
@import 'fumadocs-ui/css/neutral.css';
@import 'fumadocs-ui/css/preset.css';
/* path of `fumadocs-ui` relative to the CSS file */
@source '../node_modules/fumadocs-ui/dist/**/*.js';
@@ -1,6 +1,3 @@
@import 'tailwindcss';
@import 'fumadocs-ui/css/neutral.css';
@import 'fumadocs-ui/css/preset.css';
/* path of `fumadocs-ui` relative to the CSS file */
@source '../node_modules/fumadocs-ui/dist/**/*.js';
+2 -1
View File
@@ -17,7 +17,8 @@
"files": [
"dist/*",
"fumapy",
"styles"
"styles",
"pyproject.toml"
],
"exports": {
"./preset.css": "./styles/preset.css",
+1
View File
@@ -1,6 +1,7 @@
@import './shiki.css';
@import './animations.css';
@source '../dist/**/*.js';
@plugin '../dist/theme/typography/index.js';
@theme {
-4
View File
@@ -6,8 +6,4 @@
body {
@apply flex flex-col min-h-screen;
}
button {
cursor: pointer;
}
}