I believe the best practice is to use a dedicated "media" branch for screenshots/gifs/webp. Then you can use them on your readme like this .
You can rewrite history on the media branch so the files don't accumulate whenever you update them.
I found this idea here: https://medium.com/@minamimunakata/how-to-store-images-for-u...