From 9daf1bf86b00bd1724c21fe2f6693478d484285d Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Tue, 17 Sep 2024 18:10:51 -0600
Subject: [PATCH] first commit

---
 README.md | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cdb22f5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,53 @@
+<p align="center">
+  <img src="screenshots/icon.svg" alt="Project Logo" width="21%">
+</p>
+
+# noStrudel
+
+> NOTE: This client is still in development and will have bugs
+
+noStrudel is a web app for exploring the [nostr](https://github.com/nostr-protocol) protocol.
+
+The goal of this project is to build a nostr client that lets a user explore the nostr protocol by showing as much information as possible and letting the user view the underlying events.
+
+Live Instance: [nostrudel.ninja](https://nostrudel.ninja)
+
+There are many features missing from this client and I wont get around to implementing everything. but if you like the client you are welcome to use it.
+
+You can find more clients with more features on [nostrapps.com](https://www.nostrapps.com/) or in the [awesome-nostr](https://github.com/aljazceru/awesome-nostr) repo.
+
+## Please don't trust my app with your nsec
+
+While logging in with a secret key is supported. please don't. This is a web client, so there is always a chance of XXS attacks that could steal your secret key.
+
+I would recommend you use a browser extension like [Alby](https://getalby.com/) or [Nos2x](https://github.com/fiatjaf/nos2x)
+
+## Running with docker
+
+```bash
+docker run --rm -p 8080:80 ghcr.io/hzrd149/nostrudel:master
+```
+
+## Docker compose and other services
+
+noStrudels docker image has a few options for connecting to other services running locally
+
+- `CACHE_RELAY`: if set the client will use the relay to cache all of its events instead of storing them in the browser cache
+- `IMAGE_PROXY`: can be set to a local [imageproxy](https://github.com/willnorris/imageproxy) instance so the app can resize profile images
+- `REQUEST_PROXY`: can be set to a local [cors-anywhere](https://github.com/Rob--W/cors-anywhere) instance so the app can proxy http request
+- `PROXY_FIRST`: if this is set to `true` all http requests will go through the request proxy first
+
+You can find a full example of all these services in the [docker-compose.yaml](./docker-compose.yaml)
+
+## Running locally
+
+```bash
+git clone git@github.com:hzrd149/nostrudel.git
+cd nostrudel
+yarn install
+yarn dev
+```
+
+## Contributing
+
+This is only a personal project, so if you open any PRs please keep them small. thanks