diff --git a/README.md b/README.md
index 7bcd53e..3e210b1 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,12 @@
Web-Check
+
- Comprehensive, on-demand open source intelligence for any website
-
- 🌐 web-check.as93.net
+
+Comprehensive, on-demand open source intelligence for any website
+
+🌐 web-check.as93.net
+
---
@@ -13,26 +16,82 @@
_Get info on a websites SSL certs, domain, headers, cookies, DNS records, technologies used, performance, hostnames, crawl rules, server info and more_
#### Screenshot
-
-
-
+[](https://web-check.as93.net/)
#### Live Demo
-
A hosted version can be accessed at: **[web-check.as93.net](https://web-check.as93.net)**
+#### Mirror
+The source for this repo is mirrored to CodeBerg, available at: **[codeberg.org/alicia/web-check](https://codeberg.org/alicia/web-check)**
+
+#### Motivation
+Often when I'm looking into a website, there's several things I always check first.
+None of this is hard, and can usually be done with a series of curl commands, or using a combination of online tools.
+But it's so much easier to have everything presented clearly and visible in one place.
+
+#### Features
+- Server Location
+- SSL Info
+- Headers
+- Associated hostnames
+- Domain Whois
+- DNS records
+- Cookies
+- Server info
+- Crawl rules
+- Performance metrics
+- Screenshot
+- Tech stack
+- Site response times
+
+_Note that not all checks will work for all sites. Sometimes it's not possible to determine some information, and there are limitations imposed by Netlify for the lambda functions._
+
+#### Architecture
+It's just a very simple web app (React + TypeScript), with results calculated using a series of Lambda functions. Everything is deployed on Netlify. Most things are done with the native http interface, but there's a few instances where this wasn't possible alone, so is combined with some external APIs, like Shodan for hostnames, IP Info for geolocation, and Google Cloud for performance metrics.
---
## Building
----
+### Developing
-## Deploying
+You'll need [Node.js](https://nodejs.org/en) (V 18.16.1 or later) installed.
+
+1. Clone the repo, `git clone git@github.com:Lissy93/web-check.git`
+2. Cd into it, `cd web-check`
+3. Install dependencies: `npm i`
+4. Populate environmental variables, in the `.env`
+5. Start the dev server, with `npx netlify-cli dev`
+
+### Deploying
+
+[](https://app.netlify.com/start/deploy?repository=https://github.com/lissy93/web-check)
---
-## Contributing
+## Community
+
+### Contributing
+
+Contributions of any kind are very welcome, and would be much appreciated.
+For Code of Conduct, see [Contributor Convent](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).
+
+To get started, fork the repo, make your changes, add, commit and push the code, then come back here to open a pull request. If you're new to GitHub or open source, [this guide](https://www.freecodecamp.org/news/how-to-make-your-first-pull-request-on-github-3#let-s-make-our-first-pull-request-) or the [git docs](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) may help you get started, but feel free to reach out if you need any support.
+
+[](https://github.com/Lissy93/web-check/compare)
+
+
+### Found a Bug
+
+If you've found something that doesn't work as it should, or would like to suggest a new feature, then go ahead and raise a ticket on GitHub.
+For bugs, please outline the steps needed to reproduce, and include relevant info like system info and resulting logs.
+
+[](https://github.com/Lissy93/web-check/issues/new/choose)
+
+### Supporting
+
+[](https://github.com/sponsors/Lissy93)
+
---