Contributing to Smassh! ⌨️

January 24, 2024 · View on GitHub

Thanks for taking the time to contribute to smash

What can I contribute?

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

Adding a theme

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

Setting up Local environment

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 run ruff and black to test your code
Finally, you can run the app
```
smassh
```
If you see a typing screen that means everything is installed properly

Before opening a PR

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

Questions

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.