summaryrefslogtreecommitdiffstats
path: root/docs/src/contributing_theming.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/src/contributing_theming.md')
-rw-r--r--docs/src/contributing_theming.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/docs/src/contributing_theming.md b/docs/src/contributing_theming.md
new file mode 100644
index 00000000..25c8ca6d
--- /dev/null
+++ b/docs/src/contributing_theming.md
@@ -0,0 +1,18 @@
+# Theming Guide
+
+Lemmy uses [Bootstrap v4](https://getbootstrap.com/), and very few custom css classes, so any bootstrap v4 compatible theme should work fine.
+
+## Creating
+
+- Use a tool like [bootstrap.build](https://bootstrap.build/) to create a bootstrap v4 theme. Export the `bootstrap.min.css` once you're done, and save the `_variables.scss` too.
+
+## Testing
+
+- To test out a theme, you can either use your browser's web tools, or a plugin like stylus to copy-paste a theme, when viewing Lemmy.
+
+## Adding
+
+1. Copy `{my-theme-name}.min.css` to `ui/assets/css/themes`. (You can also copy the `_variables.scss` here if you want).
+1. Go to `ui/src/utils.ts` and add `{my-theme-name}` to the themes list.
+1. Test locally
+1. Do a pull request with those changes.