diff --git a/packages/swell/README.md b/packages/swell/README.md
new file mode 100644
index 000000000..c8fff530a
--- /dev/null
+++ b/packages/swell/README.md
@@ -0,0 +1,18 @@
+## Swell Provider
+
+Copy the `.env.template` file in this directory to `.env.local` in the main directory (which will be ignored by Git):
+
+Visit https://www.swell.is/, under your account, for the env variables
+
+```bash
+cp packages/swell/.env.template .env.local
+```
+
+Then, set the environment variables in `.env.local` to match the ones from your store.
+
+## Contribute
+
+Our commitment to Open Source can be found [here](https://vercel.com/oss).
+
+If you find an issue with the provider or want a new feature, feel free to open a PR or [create a new issue](https://github.com/vercel/commerce/issues).
+