# [<img src="./app/assets/images/logo/logo.svg" width="32">](https://hostr.network) Hostr

[![semantic-release: angular](https://img.shields.io/badge/semantic--release-angular-e10079?logo=semantic-release)](https://github.com/semantic-release/semantic-release)

Rental accommodation using purely peer‑to‑peer technologies such as [Nostr](https://nostr.com/).

<p align="start">

<img src="./app/screenshots/iphone_17_pro_max/dark/explore.png" alt="Explore page" width=200 style="max-width:300px;">&nbsp;
<img src="./app/screenshots/iphone_17_pro_max/dark/listing.png" alt="Listing page" width=200 style="max-width:300px;">&nbsp;
<img src="./app/screenshots/iphone_17_pro_max/dark/threads.png" alt="Threads page" width=200 style="max-width:300px;">&nbsp;
<img src="./app/screenshots/iphone_17_pro_max/dark/thread.png" alt="Thread page" width=200 style="max-width:300px;">&nbsp;
<img src="./app/screenshots/iphone_17_pro_max/dark/payment.png" alt="Payment page" width=200 style="max-width:300px;">&nbsp;

</p>

Read docs in full [here](https://sudonym-btc.github.io/hostr/).

This repo contains

```bash
.
├── app                 # Flutter client app deployed to stores and web
├── hostr_sdk           # SDK for relays, Hostr models, trades, messaging, swaps
├── hostr_cli           # CLI and Dart daemon used by MCP/local automation
├── models              # Custom Nostr event types and validations
├── escrow              # Escrow daemon, contracts, and settlement tooling
├── ai                  # Node/TypeScript MCP server and agent-facing automation
├── infrastructure      # Terraform, DNS, CI deploy, and hosted VM setup
├── docker              # Local/dev service config for relay, blossom, EVM, observability
├── dependencies/nips   # Vendored NIP specs plus Hostr draft NIP-XX documents
└── scripts             # Bootstrap, deploy, ABI, TLS, screenshot, and helper scripts
```

- Client [README](./app/README.md)
- Infrastructure [README](./infrastructure/README.md)
- Escrow [README](./escrow/README.md)
- AI [README](./ai/README.md)

## Nips developed

New nips are needed to facilitate escrowed transactions via nostr. We also need to extend Nip-

- [Accommodation listing NIP-XX](./dependencies/nips/accommodation-nip/XX.md)
- [Reservation lifecycle NIP-XX](./dependencies/nips/reservation-nip/XX.md)
- [Escrow services NIP-XX](./dependencies/nips/escrow-nip/XX.md)

## Clone

```bash
git clone --recursive git@github.com:sudonym-btc/hostr.git
```

Quickstart: see the client app guide at `app/README.md` for run targets by environment.