Skip to content

nima70/keycloakify-tailwind-shadcn

Β 
Β 

Repository files navigation

πŸš€ Keycloakify + Tailwind CSS & ShadCN UI: Enhancing Keycloak Themes πŸš€

Welcome to the Keycloakify + Tailwind CSS & ShadCN UI repository! This project is a community-driven effort aimed at making Keycloak theming more accessible, modern, and easy to customize. By integrating Tailwind CSS and ShadCN UI, I am upgrading the Keycloakify ecosystem, one page at a time, to meet the needs of modern front-end development.

This project is designed to be developer-friendly, making it easy to customize themes or individual components to suit your specific needs. With the help of Storybook, developers can modify components in isolation, streamlining the customization process.

I strongly believe in the Keycloak ecosystem and found Keycloakify to be an extremely stable and reliable tool for creating custom Keycloak themes. My goal is to further enhance Keycloakify for this specific front-end use case and to make it easier for others to build on top of my work.

Watch the video

πŸ“’ Spoiler Alert

🚨 Spoiler Alert: We’ve just initiated support for multiple screen sizes as of 16/9/2024! 🚨
If things look a bit off on mobile phones or smaller screens, no worriesβ€”we're actively working on making this project fully responsive.
Stay tuned for exciting updates and improvements coming soon!

🌟 Live Demo

You can explore and test the components used in this project through the live Storybook:

View Storybook

πŸ’‘ Why This Project?

This project is designed to help the Keycloak developer community by providing a ready-to-use template that integrates Tailwind CSS and ShadCN UI components. Developers can now easily build on this foundation, customizing either the entire theme or individual components in isolation using Storybook. With these tools, creating modern, responsive Keycloak UIs is easier than ever.

Contributions are highly encouraged! Whether you're passionate about Keycloak, Tailwind CSS, or ShadCN, let's collaborate to make Keycloak theming easier and more powerful for everyone.

Watch the video

πŸš€ Quick Start

Clone this repository:

git clone https://github.com/nima70/keycloakify-tailwind-shadcn.git

Install dependencies:

npm install --legacy-peer-deps

Run the project locally:

npm run prestart
npm run storybook

πŸ›  Tailwind CSS & ShadCN UI Integration

This project integrates Tailwind CSS and ShadCN UI components with Keycloakify, making it easier to create custom Keycloak themes. You can easily customize individual components or the entire theme by leveraging Storybook.

Isolated Component Customization with Storybook: Every component in this project is storybook-ready, allowing you to develop and customize components in isolation. This means you can focus on fine-tuning each UI element without worrying about the rest of the application. Storybook helps in visually testing and experimenting with different styles and themes. With the integration of Tailwind CSS, you get access to utility-first CSS for rapid styling, while ShadCN UI components provide a robust design system for professional UIs.

Pages Currently Enhanced:

  • Login Page
  • Terms Page
  • Register Page (in progress)
  • Error
  • Code
  • Delete Account Confirm
  • Delete Credential
  • Frontchannel Logout
  • Idp Review UserProfile
  • info
  • Login Config Totp
  • Login Idp Link Confirm
  • Login Idp Link Email
  • Login Oauth Grant
  • Login Otp
  • Login Page Expired
  • Login Password
  • Login Reset Otp
  • Login Updatte Password
  • Login Update Profile
  • Login Username
  • Login Verify Email
  • Login x509 Info
  • Logout Confirm
  • Saml Post Form
  • Select Authenticator
  • Update Email
  • Web Authn Authenticate
  • Web Authn Error
  • Web Authn Register
  • Web Authn Error
  • Login Oauth2 Device Verify User Code
  • Login Recovery Authn Code Config
  • Login Recovery Authn Code input

Stay tuned as more pages are upgraded with Tailwind CSS and ShadCN UI components!

πŸ“¦ Building the Keycloak Theme

You need Maven installed to build the Keycloak theme.

Install Maven:

macOS:

brew install maven

Debian/Ubuntu:

sudo apt-get install maven

Windows:

choco install openjdk && choco install maven

Build the Keycloak theme:

npm run build-keycloak-theme

Keycloakify generates .jar files for different Keycloak versions by default. You can customize this to suit your deployment needs. Learn more in the Keycloakify documentation.

🀝 How You Can Contribute

I am eager to collaborate with others who are passionate about Keycloak, Tailwind CSS, or ShadCN UI. Here’s how you can get involved:

  • Fork this repository, and submit pull requests to contribute new features or improvements.
  • Test and customize individual components using Storybook and contribute improvements to them.
  • Open issues to discuss ideas for future enhancements or provide feedback. Spread the word by starring this repository and sharing it with the community. Together, we can create a modern, highly customizable Keycloak UI for everyone!

🎯 Keywords & Tags

  • Keycloak custom themes
  • Tailwind CSS for Keycloak
  • ShadCN UI integration
  • Keycloakify customization
  • Modern Keycloak theming
  • Storybook for Keycloak components
  • Open-source Keycloak themes
  • Responsive Keycloak themes

πŸ“„ License

This project is licensed under the MIT License.

Contact

Have questions or want to collaborate? Feel free to open an issue or reach out via email.

About

πŸ”‘ Keycloakify Projects for tailwind css and Shadcn

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 91.6%
  • JavaScript 4.6%
  • CSS 3.5%
  • HTML 0.3%