# locadot 🔐

## ✨ Features

- ✅ Automatically generates trusted local SSL certificates
- 🔁 Reverse proxies `localhost:PORT ` → `https://your.custom.domain.localhost`
- 🖥️ Works on Windows, macOS, and Linux
- 🛠️ OS-specific guidance for host setup
- ⚠️ Warns and exits if domain isn’t correctly mapped to a local IP
- ❌ Only supports proxying to localhost ports – external IPs are not allowed for security

---

## 🚀 Usage

```bash
npx locadot add --host dev.localhost --port 3350
```

---

## 📦 Commands

##### ▶️ Default (Run Proxy)

###### Starts a reverse proxy to the specified localhost port.

```bash
npx locadot add --host <custom.localhost> --port <localhost-port>
```

##### 🧾 Update existing host

###### Update domains currently registered with locadot.

```bash
npx locadot update --host <your.localhost> --port <localhost-port>
```


##### 🧾 Remove existing host

###### Remove domains currently registered with locadot.

```bash
npx locadot remove --host <your.localhost>
```

##### 🧾 View Registered Hosts

###### Displays all domains currently registered with locadot.

```bash
npx locadot host
```

##### 📺 Watch Logs

###### Continuously watches and outputs proxy logs in real time.

```bash
npx locadot watch:logs
```

##### 🧹 Clear Logs

###### Clears all saved logs.

```bash
npx locadot clear:logs
```

##### 🧹 Clear Hosts

###### Clears all existing hosts.

```bash
npx locadot clear:hosts
```

##### 🧹 Show Config Path

###### Print the path of config files used.

```bash
npx locadot path
```

##### 🧹 Show Logs Path

###### Print the path of logged files used.

```bash
npx locadot path:logs
```


##### 🧹 Show Hosts Path

###### Print the path of hosts files used.

```bash
npx locadot path:hosts
```

##### 🔄 Restart Proxy

###### Restarts the proxy server and reloads configuration.

```bash
npx locadot restart
```

##### 🛑 Stop All

###### Stops all running locadot hosts and shuts down the proxy server.

```bash
npx locadot stop
```

##### 🛑 Kill

###### Stops all running locadot hosts, clear logs and host mapping and shuts down the proxy server.

```bash
npx locadot kill
```

---

### 🙌 Contributing:

Pull requests are welcome! Feel free to open issues for bugs or feature requests. Contributions help improve locadot for everyone, so don't hesitate to get involved.

---

##### Made with ❤️ to make secure local development simple.