Thanks for taking the time to contribute to smash
You can do that in a lot of ways
- Add a theme
- Report a bug ( see GitHub issue tracker )
- Suggest a new feature or enhancement ( see GitHub issue tracker )
- Open a PR for any of the reasons above
Currently, we're using themes from monkeytype but if you feel like some theme is missing, feel free to open a PR to add it! \
The theme format is pretty simple and you can look into any of the theme files
Steps:
- Create a new theme file with
.tcss
extension - Place it inside dir
smassh/ui/css/themes
(smassh will automatically detect the new theme) - Run the app (see setup) and select the theme ( see setup )
- make sure everything looks as expected
Note
We are using poetry but you can use any alternative if you want
Steps:
-
Fork and Clone the repo to your local machine
-
run
poetry shell
This should create an isolated virtual environment for you -
run
poetry install
This will install all the required and dev dependencies -
run
pre-commit
install
This will set pre-commit hooks for GitHub which will automatically runruff
andblack
to test your code -
Finally, you can run the app
smassh
-
If you see a typing screen that means everything is installed properly
Before you open your PR, please go through this checklist and make sure you've checked all the items that apply:
- Update the
CHANGELOG.md
- Format your code with black
- All your code has docstrings in the style of the rest of the codebase
If you have any questions, comments, concerns, or problems let me know on Discord or ask a question on Smassh's GitHub discussions and I'll be happy to assist you.