diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f6fcefc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,63 @@
+
+
+ Stoat for Desktop
+
+ [](https://github.com/stoatchat/for-desktop/stargazers)
+ [](https://github.com/stoatchat/for-desktop/network/members)
+ [](https://github.com/stoatchat/for-desktop/pulls)
+ [](https://github.com/stoatchat/for-desktop/issues)
+ [](https://github.com/stoatchat/for-desktop/graphs/contributors)
+ [](https://github.com/stoatchat/for-desktop/blob/main/LICENSE)
+
+Application for Windows, macOS, and Linux.
+
+
+
+## Development Guide
+
+_Contribution guidelines for Desktop app TBA!_
+
+
+
+Before getting started, you'll want to install:
+
+- Git
+- Node.js
+- pnpm (run `corepack enable`)
+
+Then proceed to setup:
+
+```bash
+# clone the repository
+git clone --recursive https://github.com/stoatchat/for-desktop stoat-for-desktop
+cd stoat-for-desktop
+
+# install all packages
+pnpm i --frozen-lockfile
+
+# start the application
+pnpm start
+# ... or build the bundle
+pnpm package
+# ... or build all distributables
+pnpm make
+```
+
+### Pulling in Stoat's assets
+
+If you want to pull in Stoat brand assets after pulling, run the following:
+
+```bash
+# update the assets
+git -c submodule."assets".update=checkout submodule update --init assets
+```
+
+Currently, this is required to build, any forks are expected to provide their own assets.
+
+## Publishing Guide
+
+To publish a new version, simply tag a new release by:
+
+1. Edit `package.json` with the new version
+2. Create a new tag from latest commit by `git tag v1.0.0`
+3. Push the tag and commit by `git push --atomic origin main v1.0.0`