Skip to content

docs: update frontend contributing guide for shadcn/ui and TailwindCSS migration #18702

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

BrunoQuaresma
Copy link
Collaborator

Update the frontend contributing guide to reflect the current architecture and ongoing migration from MUI to shadcn/ui and from Emotion to TailwindCSS.

Key changes:

  • Updated tech stack to include TailwindCSS, shadcn/ui, Lucide React, and Biome
  • Added migration status section with current progress (~210 MUI files, ~41 migrated)
  • Added development commands section with pnpm commands and pre-PR checklist
  • Rewrote UI components section to prioritize shadcn/ui over MUI
  • Completely updated styling section to focus on TailwindCSS
  • Enhanced accessibility section with TailwindCSS examples
  • Added comprehensive migration guide with practical examples and checklists
  • Documented semantic color system and best practices

…S migration

Update the frontend contributing guide to reflect the current architecture
and ongoing migration from MUI to shadcn/ui and from Emotion to TailwindCSS.

Key changes:
- Updated tech stack to include TailwindCSS, shadcn/ui, Lucide React, and Biome
- Added migration status section with current progress (~210 MUI files, ~41 migrated)
- Added development commands section with pnpm commands and pre-PR checklist
- Rewrote UI components section to prioritize shadcn/ui over MUI
- Completely updated styling section to focus on TailwindCSS
- Enhanced accessibility section with TailwindCSS examples
- Added comprehensive migration guide with practical examples and checklists
- Documented semantic color system and best practices

Co-authored-by: BrunoQuaresma <[email protected]>
@BrunoQuaresma BrunoQuaresma requested review from f0ssel and a team July 1, 2025 19:19
@BrunoQuaresma BrunoQuaresma self-assigned this Jul 1, 2025
@BrunoQuaresma BrunoQuaresma requested review from brettkolodny and removed request for a team July 1, 2025 19:19
blink-so bot and others added 2 commits July 1, 2025 19:24
Ran make fmt and frontend linting to ensure code quality:
- Go formatting: passed
- Terraform formatting: passed
- Frontend formatting (Biome): passed (1124 files, no fixes needed)
- Frontend linting (Biome): passed (1124 files, no issues)

No changes were required as the code already meets all formatting standards.

Co-authored-by: BrunoQuaresma <[email protected]>
Fixed 11 markdown linting errors found by markdownlint-cli2:
- MD022: Added blank lines around headings
- MD032: Added blank lines around lists (9 instances)
- MD031: Added blank lines around fenced code blocks
- MD040: Added language specification to fenced code block

All markdown linting rules now pass with 0 errors.

Co-authored-by: BrunoQuaresma <[email protected]>
Copy link

Choose a reason for hiding this comment

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

🚫 [linkspector] reported by reviewdog 🐶
Cannot reach https://stackoverflow.com/questions/69711888/react-testing-library-getbyrole-is-performing-extremely-slowly Status: 403

- <https://stackoverflow.com/questions/69711888/react-testing-library-getbyrole-is-performing-extremely-slowly>

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant