Skip to content

docs: add section about multiple Tailwind configs#3273

Merged
delucis merged 7 commits intowithastro:mainfrom
HiDeoo:hd-docs-tailwind-multiple-config-again
Aug 19, 2025
Merged

docs: add section about multiple Tailwind configs#3273
delucis merged 7 commits intowithastro:mainfrom
HiDeoo:hd-docs-tailwind-multiple-config-again

Conversation

@HiDeoo
Copy link
Copy Markdown
Member

@HiDeoo HiDeoo commented Jul 2, 2025

Description

This PR supersedes #3198 based on the discussions that happened in the last T&D session and updates the Tailwind instructions to help with issue 6 in #3162:

When using custom pages or Starlight at a subpath and want to use Tailwind on both your main site/custom pages and Starlight, you propably want to use a default Tailwind setup for your main website/custom pages and a different one for Starlight which would use the Starlight’s Tailwind compatibility package.

Compared to #3198, this PR adds a section focusing on Tailwind configurations and emphasizes that multiple configurations can be used in a single project by creating additional CSS files rather than trying to cover all possible scenarios.

@netlify
Copy link
Copy Markdown

netlify bot commented Jul 2, 2025

Deploy Preview for astro-starlight ready!

Name Link
🔨 Latest commit f26dc4d
🔍 Latest deploy log https://app.netlify.com/projects/astro-starlight/deploys/68a4ade72be69d00087b7945
😎 Deploy Preview https://deploy-preview-3273--astro-starlight.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 100 (no change from production)
Accessibility: 100 (no change from production)
Best Practices: 100 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions bot added the 📚 docs Documentation website changes label Jul 2, 2025
@astrobot-houston
Copy link
Copy Markdown
Contributor

astrobot-houston commented Jul 2, 2025

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

Locale File Note
en guides/css-and-tailwind.mdx Source changed, localizations will be marked as outdated.
Warnings reference
Icon Description
🔄️ The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

Copy link
Copy Markdown
Member

@louisescher louisescher left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few small nitpicks, good docs otherwise!

Co-authored-by: Louis Escher <66965600+louisescher@users.noreply.github.com>
@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Jul 3, 2025

⚠️ No Changeset found

Latest commit: f26dc4d

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

trueberryless added a commit to trueberryless/withastro-starlight that referenced this pull request Jul 10, 2025
Copy link
Copy Markdown
Member

@delucis delucis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Totally forgot about this one, sorry. Left a few suggestions!

Co-authored-by: delucis <357379+delucis@users.noreply.github.com>
@HiDeoo
Copy link
Copy Markdown
Member Author

HiDeoo commented Aug 19, 2025

Thanks for the great review 🙌

The suggestions makes it definitely more clear and I personally love the usage of <Steps> in this context.

Copy link
Copy Markdown
Member

@delucis delucis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oops, re-reading my suggestions properly in the preview and I spotted a couple of typos to improve.

But I think apart from those it should be good to go!

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
@HiDeoo
Copy link
Copy Markdown
Member Author

HiDeoo commented Aug 19, 2025

Oops, re-reading my suggestions properly in the preview and I spotted a couple of typos to improve.

And I successfully managed to not spot any of them while manually adding the changes 🙈 😅

Copy link
Copy Markdown
Member

@delucis delucis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Third approval’s the charm 😁

LGTM 🚀

@delucis delucis merged commit 7d8246b into withastro:main Aug 19, 2025
16 checks passed
@HiDeoo HiDeoo mentioned this pull request Aug 19, 2025
1 task
ArmandPhilippot added a commit to ArmandPhilippot/starlight that referenced this pull request Aug 20, 2025
HiDeoo added a commit to HiDeoo/starlight that referenced this pull request Aug 26, 2025
* main: (55 commits)
  i18n(de): translate `themes.mdx` (withastro#3397)
  [ci] format
  i18n(ko): translate `themes.mdx` (withastro#3398)
  [ci] format
  docs: add Starlight Page to themes showcase (withastro#3393)
  i18n(de): update German themes (withastro#3394)
  docs: change image of Starlight Galaxy Theme dark image to not include a visible scrollbar (withastro#3395)
  [ci] format
  i18n(ko-KR): update `themes.mdx` (withastro#3392)
  [ci] format
  Add link to new Starlight theme (withastro#3390)
  i18n(fr): update `guides/css-and-tailwind.mdx` (withastro#3389)
  i18n(de): translate `guides/css-and-tailwind.mdx` (withastro#3386)
  [ci] format
  i18n(ko-KR): update `css-and-tailwind.mdx` (withastro#3388)
  Adds OmniPrint documentation to the showcase (withastro#3387)
  docs(showcase): Add Aptos Docs (withastro#3385)
  docs: add section about multiple Tailwind configs (withastro#3273)
  Add basic ESLint config, lint script and lint CI job (withastro#1640)
  chore(deps): update actions/checkout action to v5 (withastro#3375)
  ...
HiDeoo added a commit to HiDeoo/starlight that referenced this pull request Aug 27, 2025
* main: (137 commits)
  i18n(fr): update `resources/themes.mdx` (withastro#3399)
  i18n(de): translate `themes.mdx` (withastro#3397)
  [ci] format
  i18n(ko): translate `themes.mdx` (withastro#3398)
  [ci] format
  docs: add Starlight Page to themes showcase (withastro#3393)
  i18n(de): update German themes (withastro#3394)
  docs: change image of Starlight Galaxy Theme dark image to not include a visible scrollbar (withastro#3395)
  [ci] format
  i18n(ko-KR): update `themes.mdx` (withastro#3392)
  [ci] format
  Add link to new Starlight theme (withastro#3390)
  i18n(fr): update `guides/css-and-tailwind.mdx` (withastro#3389)
  i18n(de): translate `guides/css-and-tailwind.mdx` (withastro#3386)
  [ci] format
  i18n(ko-KR): update `css-and-tailwind.mdx` (withastro#3388)
  Adds OmniPrint documentation to the showcase (withastro#3387)
  docs(showcase): Add Aptos Docs (withastro#3385)
  docs: add section about multiple Tailwind configs (withastro#3273)
  Add basic ESLint config, lint script and lint CI job (withastro#1640)
  ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

📚 docs Documentation website changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants