Add README

README.md

@@ -1,8 +1,72 @@
-# Pocket Bird (Work in Progress!)
+# Pocket Bird
 
-This project is still being worked on, but if you wish to help me beta test it, join the [Discord](https://discord.gg/6yxE9prcNc) and  follow the installation instructions below!
+![License](https://img.shields.io/github/license/IdreesInc/Pocket-Bird)
+[![Chrome Web Store Version](https://img.shields.io/chrome-web-store/v/lbbdngkbbgaecefacpnhnhleggabghak)](https://chromewebstore.google.com/detail/pocket-bird/lbbdngkbbgaecefacpnhnhleggabghak)
+[![Mozilla Add-on Version](https://img.shields.io/amo/v/pocket-bird)](https://addons.mozilla.org/en-US/firefox/addon/pocket-bird/)
+
+![](images/preview.png)
+
+It's a pet bird that hops around your browser, what more could you want?
+
+### Get it for [Google Chrome](https://chromewebstore.google.com/detail/pocket-bird/lbbdngkbbgaecefacpnhnhleggabghak)
+
+### Get it for [Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/pocket-bird/)
+
+#### Join the [Discord](https://discord.gg/6yxE9prcNc) to help me beta test new features and suggest ideas!
+
+## Features
+
+- A cute little pixel art bird hops around your webpages as you browse
+- Collect rare falling feathers to unlock over 10+ different species of birds
+- Add sticky notes that stay on the page even after you refresh
+- And most importantly, you can pet the bird!
+
+## Installation
+
+### Browser Extension
+
+### Google Chrome / Microsoft Edge
+
+1. Go to the [Chrome Web Store page](https://chromewebstore.google.com/detail/pocket-bird/lbbdngkbbgaecefacpnhnhleggabghak)
+2. Click "Add to Chrome" (or "Add to Edge" if using Microsoft Edge)
+3. Confirm any permission prompts that appear
+
+### Mozilla Firefox
+1. Go to the [Mozilla Add-ons page](https://addons.mozilla.org/en-US/firefox/addon/pocket-bird/)
+2. Click "Add to Firefox"
+3. Confirm any permission prompts that appear
+
+### Userscript
+
+*Note that this is mainly used for beta testing new features, installation via browser extension is recommended for the best experience.*
 
 1. Install [Tampermonkey](https://www.tampermonkey.net/) on your web browser
 2. Enable the Tampermonkey extension and give it the permissions requested
 3. Install my Pocket Bird script by going to this link and clicking install: [https://github.com/IdreesInc/Pocket-Bird/raw/refs/heads/main/dist/userscript/birb.user.js](https://github.com/IdreesInc/Pocket-Bird/raw/refs/heads/main/dist/userscript/birb.user.js)
-4. Now any websites you visit will have a little bird hopping around!
+4. Now any websites you visit will have a little bird hopping around!
+
+## FAQ
+
+### How do I pet the bird?
+
+Simply move your cursor back and forth over your bird until a heart appears! You can also click the bird to open the menu and pet it from there. There may even be a slightly greater chance of finding a feather when your bird is well loved...
+
+### How do I collect feathers?
+
+Feathers will occasionally fall from the top of your browser window. Clicking on a feather will add a new species to your field guide, allowing you to change the appearance of your pet!
+
+### How do I change my bird's appearance?
+
+Once you've unlocked new species by collecting feathers, you can change your bird's appearance by opening the Pocket Bird menu (click the bird) and selecting "Field Guide".
+
+### How do I add sticky notes?
+
+Open the Pocket Bird menu by clicking the bird and select "Sticky Note". From there, you can add, edit, and delete notes that will stay on the page even after refreshing.
+
+### How do I hide the bird?
+
+Open the Pocket Bird menu by clicking the bird and select "Settings". From there, you can toggle the bird's visibility on and off temporarily on the current page.
+
+### How can I get in touch?
+
+If you'd like to get in touch, check out the [Discord](https://discord.gg/6yxE9prcNc) to suggest features, report bugs, and stay updated on development!