---
title: README
emoji: 🎨
colorFrom: indigo
colorTo: pink
sdk: static
pinned: false
---
# Welcome to the Gradio Themes Party 🎉
## Join the organization by clicking <a href="https://huggingface.co/organizations/Gradio-Themes/share/aaChyOhGMEByezOJNwPiwWPvNraBWcQIYX" style="text-decoration: underline">Dummy link</a>
### <a href="https://huggingface.co/spaces/Gradio-Themes/Leaderboard" style="text-decoration: underline">Live Themes Gallery</a> will show Gradio Themes that are created by participants and they will be sorted by likes.
![Gradio Theme Party Banner](./theme_header.png)

- We are excited to invite you to the Gradio Themes Party - a community event in which we will create <b>beautiful and personalized Themes</b>
  for the Gradio apps. The event will take place from <b>March 20th, Monday to April 2nd, Sunday</b>.
  We will be organizing this event on
  <a href="https://huggingface.co/Gradio-Themes" target="_blank" style="text-decoration: underline">Hugging Face Spaces</a>
  and would be engaging through Discord using <a href="https://discord.com/invite/feTf9x3ZSB" target="_blank" style="text-decoration: underline">Hugging Face Discord server</a>.
  Check the dedicated Gradio channel for staying up to date with the event. Prizes will be given at the end of the event, see the <a href="#Prizes" target="_blank" style="text-decoration: underline">Prizes section</a>.</p><br />

- Gradio is a popular choice for building demos for machine learning models, as it allows you to create web-based UIs all in Python. The interface of the Gradio is very important since it directly affects the user experience of the application. We believe that a visually appealing interface can make the application more attractive to the users. Therefore, we have launched a brand new and exciting feature called **Gradio Themes** which can help you add themes, personalize your app, improve UX and much more. We have decided to organize the Gradio Themes Party to encourage the developer community to develop stunning and impressive themes for their Gradio apps and fronts-ends.

- To learn more about Gradio see the Getting Started Guide:  <a href="https://gradio.app/getting_started/" target="_blank" style="text-decoration: underline">https://gradio.app/getting_started/</a></p>

- To learn more about Gradio Themes see the Themes Guide at:  <a href="https://gradio.app/getting_started/" target="_blank" style="text-decoration: underline">https://gradio.app/themes_guide/</a></p>

- Gradio can be installed via pip and comes preinstalled in Hugging Face Spaces, the latest version of Gradio that supports Themes is 3.22 and it can be set in the README in Spaces by setting the sdk_version, for example <code>sdk_version: 3.22.0</code></p>

- Using Gradio Themes, you can use default themes (for example, Base, soft, Glass, Monochrome, etc.), extend existing theme very easily, or create your own themes from scratch.

## Hackathon Tracks :
Participants can take part in different tracks of the Themes Hackathon. Each track will have winners announced at the end of the event! These events are 
1. The **Theme Creation Contest** - Participants would compete to create the most creative or visually stunning theme for a Gradio app. We can add best/most creative themes to deafult ones as a prize plus some goodies for top three winners.
2. **Building Sector-specific themes** - Participants would create Gradio themes targeting specific sectors like finance/health/education/art. Participants can also create themes specific to different companies - for example, openai green theme / huggingface emoji theme / meta blue theme etc.
3. **Inclusivity or Accessibility** focussed themes - Participants can submit apps build around themes that support inclusivity in the community. Accessibility is also a key area for this segment, for example building app using themes that suite colorblind people or apps with theme that supports a cause like 'diversity and inclusion' etc.
4. **Best Dark Toggle** - In this segment participants will design a theme that supports the best effects with dark mode toggle.
5. **Gradio in disguise🥸** themes - We encourage participants to design Gradio themes that would take Gradio look and feel farthest from the default Gradio theme. This can include considerations for colors, button designs, fonts, backgrounds and much more.
6. **Gradio App redesign challenge** - Participants will be challenged to redesign an existing trending Gradio app using new and creative themes. Participants can pick up an existing Gradio application and make it better in terms of user experience using Themes. Apps that would be made more visually appealing and user-friendly would be considered for this prize.
7. **Gradio Apps using Themes** - We encourage participants to build cool demos and use Themes along with it. You can use default themes, or extend them or create new themes from scratch while building a cool Gradio demo. 

## How to Participate :
- Join the Gradio-Theme Party organization on Hub.
- Read up about Gradio's new theming capabilities here - [Thiming Guide](https://gradio.app/theming-guide/ )
- For tracks 1 to 5, you have to submit a new Theme: 
  - Create a brand new theme: Either extend the default or other user-generated themes or create a new theme from scratch (To add code sample)
  - Upload the theme to the Theme Gallery in the Hub (To add code sample)
- For tracks 6 & 7, you have to submit a Gradio demo: 
  - Gradio App redesign challenge: Duplicate a  brand new theme: Either extend the default or other user-generated themes or create a new theme from scratch (To add code sample)
  - Upload the theme to the Theme Gallery in the Hub (To add code sample)
- Share your themes with the community on social media and Spread the word about the Hackathon
- Earn prizes based on the categories given

## Prizes
We would like for you to have tons of fun in this Hackathon. So, you can make as many submissions as you would want.
- For the themes submitted for categories 1 to 5 - Top 3 winners will be based on the number of likes.
  - Hugging Face PRO subscription for x time
  - We'll add the most liked theme to our set of default ones 🤩 as a prize plus some goodies for the top three winners
- For categories 6 and 7 - Top 3 Gradio Apps will be decided by Huggingface and Gradio team based on aesthetics
  - Swag from Hugging Face merch shop: t-shirt, hoodie, or mug of your choice
  - Hugging Face PRO subscription for 1 month
- Themes event badge on HF for all participants!

## Possible To dos :
- We need to build Theme customization threads / guides / youtube videos - To teach participants how to create custom themes, work with core variables, and extend themes via constructors and the .set() method. Following the videos, participants can showcase their newly-created themes.
- We need to decide how the participants can share their Themes with the wider community. This can help us in setting up a community around Gradio and would also foster creativity.
- Create a gallery of Gradio apps that showcase different themes. Participants can submit their own Gradio apps with different themes and showcase them in a gallery. This can be a great way to showcase the versatility of the Gradio themes feature.