diff --git a/README.md b/README.md
index 3ad602d..cf79681 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,14 @@
+
+
+
+
# xmrcheckout.com
Non-custodial Monero checkout software for merchants. Payments go directly from the customer to the merchant wallet.
-This project is intentionally conservative by design:
+xmrcheckout is open source and self-hostable. It creates invoices, shows payment instructions, and watches the chain for incoming payments using view-only wallet access (address + secret view key). It can also notify your systems via API and webhooks.
+
+Hard rules:
- It never requests or stores private spend keys.
- It never signs transactions.
- It never moves funds on behalf of users.
@@ -10,6 +16,7 @@ This project is intentionally conservative by design:
## Contents
+- [Who it's for](#who-its-for)
- [What it does](#what-it-does)
- [Trust model](#trust-model)
- [Repository layout](#repository-layout)
@@ -19,24 +26,33 @@ This project is intentionally conservative by design:
- [Self-hosted deployment (no Docker)](#self-hosted-deployment-no-docker)
- [Development (API)](#development-api-python)
+## Who it's for
+
+If you want Monero payments to go straight to your own wallet, this is for you.
+
+Common fits:
+- A merchant who wants a clean hosted checkout UI (self-hosted by you).
+- A team that wants API + webhooks to plug into an existing order flow.
+- Anyone who prefers a conservative trust model (view-only access for detection).
+
## What it does
-At a high level:
+Typical flow:
1. Your integration creates an invoice (defined in XMR).
2. The UI shows payment instructions (address + amount).
3. The system observes the chain using view-only wallet access to detect payments and update invoice status.
4. Optional integrations (for example webhooks) can be used to trigger your internal order flow.
-What it does not do:
+Not included (by design):
- It does not provide custody, refunds, or any fund-moving automation.
- It does not act as a financial intermediary.
- It does not touch fiat rails in the core system.
## Trust model
-- Funds always move from the customer to the merchant wallet; xmrcheckout only observes the chain to detect payments.
-- The maximum permission level is view-only wallet access (wallet address + private view key).
-- If any configuration or integration implies spend authority, treat it as a misconfiguration.
+- Funds always move from the customer to the merchant wallet; xmrcheckout only observes the chain and reports status.
+- You keep spend authority. The maximum permission level xmrcheckout uses is view-only wallet access (wallet address + private view key).
+- If any configuration or integration implies spend authority, treat it as a misconfiguration and stop.
## Repository layout
@@ -45,6 +61,30 @@ What it does not do:
- `docker-compose.yml`: local stack and self-hosted deployment
- `nginx/`: optional reverse proxy / TLS termination (used by Docker Compose)
+## Screenshots
+
+Post-login UI:
+
+### Dashboard
+
+
+
+### Invoices
+
+
+
+### Create invoice
+
+
+
+
+
+
+
+### Public invoice page
+
+
+
## Quick start
### Homepage only (Docker)
diff --git a/screenshots/create_invoice_fiat.png b/screenshots/create_invoice_fiat.png
new file mode 100644
index 0000000..e774c02
Binary files /dev/null and b/screenshots/create_invoice_fiat.png differ
diff --git a/screenshots/create_invoice_summary.png b/screenshots/create_invoice_summary.png
new file mode 100644
index 0000000..a7f5e54
Binary files /dev/null and b/screenshots/create_invoice_summary.png differ
diff --git a/screenshots/create_invoice_xmr.png b/screenshots/create_invoice_xmr.png
new file mode 100644
index 0000000..6ad2920
Binary files /dev/null and b/screenshots/create_invoice_xmr.png differ
diff --git a/screenshots/public_invoice_pending_payment.png b/screenshots/public_invoice_pending_payment.png
new file mode 100644
index 0000000..c4da7eb
Binary files /dev/null and b/screenshots/public_invoice_pending_payment.png differ
diff --git a/screenshots/ui_dashboard.png b/screenshots/ui_dashboard.png
new file mode 100644
index 0000000..3650f1e
Binary files /dev/null and b/screenshots/ui_dashboard.png differ
diff --git a/screenshots/ui_invoices.png b/screenshots/ui_invoices.png
new file mode 100644
index 0000000..2aaa42d
Binary files /dev/null and b/screenshots/ui_invoices.png differ