Skip to content

Conversation

@codewithzubair07
Copy link

What changed

  • Removed inline styles from multiple MDX documentation pages
  • Replaced them with class-based styling to avoid mixed styling approaches

Why

  • Improves consistency and maintainability of docs styling

Closes #744

@codewithzubair07 codewithzubair07 requested a review from a team as a code owner January 17, 2026 12:27
@DeveloperAlly DeveloperAlly self-requested a review January 18, 2026 10:54
@DeveloperAlly DeveloperAlly added the Docs:v2 v2 of Documentation Label label Jan 18, 2026
@DeveloperAlly
Copy link
Collaborator

Apologies, I should have been clearer.

Details

-b docs-v2 houses styles in /snippets (multiple custom components), inline on pages themselves (under v2/pages) and in styles.css(root).

The old documentation is being fully replaced by the docs-v2 branches (most up to date currently being docs-v2-preview branch).

I'm not a style expert, but I understand you can use either tailwind (I haven't as I hadn't used it before and had enough learning curbs here :P) or otherwise you are limited to using the styles.css file in root (cannot create multiple of these ie. per page/grouping), or by styling inline on pages (.mdx) or in components (.jsx).

My thought is that:

Thoughts on homogenous style framework

If true

    1. Global styles and overrides should be housed in styles.css
    1. Components must have styles defined within the component themselves
    1. No page should have inline styles: either the style is converted to a component or it uses a global style className.

Sorry for the misunderstanding here.

@codewithzubair07
Copy link
Author

Apologies, I should have been clearer.

Details

-b docs-v2 houses styles in /snippets (multiple custom components), inline on pages themselves (under v2/pages) and in styles.css(root).

The old documentation is being fully replaced by the docs-v2 branches (most up to date currently being docs-v2-preview branch).

I'm not a style expert, but I understand you can use either tailwind (I haven't as I hadn't used it before and had enough learning curbs here :P) or otherwise you are limited to using the styles.css file in root (cannot create multiple of these ie. per page/grouping), or by styling inline on pages (.mdx) or in components (.jsx).

My thought is that:

Thoughts on homogenous style framework

If true

    1. Global styles and overrides should be housed in styles.css
    1. Components must have styles defined within the component themselves
    1. No page should have inline styles: either the style is converted to a component or it uses a global style className.

Sorry for the misunderstanding here.

Thanks for clearing that up — that makes sense now
I’ll switch over to the docs-v2-preview branch and focus on tidying up styles in the v2 pages. I’ll try to reduce inline styles and move things into shared styles or components where it feels right, keeping Mintlify’s quirks in mind.
I’ll open a new PR once I’ve got a decent clean pass. Let me know if there’s anything specific you’d like me to look at first!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Docs:v2 v2 of Documentation Label

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Clean up styles

2 participants