From 7e33b5eb925ed528f4a627fd77e2f97793cbe4ed Mon Sep 17 00:00:00 2001
From: Vitalii Miagkov <73880785+maposia@users.noreply.github.com>
Date: Tue, 15 Apr 2025 20:46:45 +0300
Subject: [PATCH] Update awesome readme list

---
 docs/awesome-remnawave/index.md | 113 ++++++++++++++++++++++++++++++++
 1 file changed, 113 insertions(+)

diff --git a/docs/awesome-remnawave/index.md b/docs/awesome-remnawave/index.md
index 28162c5..5525946 100644
--- a/docs/awesome-remnawave/index.md
+++ b/docs/awesome-remnawave/index.md
@@ -152,6 +152,119 @@ sudo bash -c "$(curl -sL https://github.com/DigneZzZ/remnawave-scripts/raw/main/
 
 ---
 
+### Remnawave Telegram Subscription Mini App
+
+This is the Telegram Subscription Mini. App The page allows see their subscriptions directly through Telegram. As a requirement for using the page, the Telegram ID must be set in the user's profile to ensure proper identification and linking of subscriptions.
+
+Features:
+
+- View your subscriptions in the mini app
+- Multi-language support (English, Russian)
+
+Author: [maposia](https://github.com/maposia)
+
+### Environment Variables
+
+The application requires the following environment variables to be set:
+
+| Variable          | Description                                                                                                   |
+|-------------------|---------------------------------------------------------------------------------------------------------------|
+| `REMNAWAVE_URL`   | Remnawave API PLAIN DOMAIN(panel.domain.com)                                                                  |
+| `REMNAWAVE_MODE`  | Remnawave mode (remote/local), default is remote. If local set – you can pass remnawave:3000 to REMNAWAVE_URL |
+| `REMNAWAVE_TOKEN` | Authentication token for Remnawave API                                                                        |
+| `BUY_LINK`        | The URL for purchase actions                                                                                  |
+| `CRYPTO_LINK`     | Allows using encrypted links (currently supported Happ application)           
+
+#### Install and Run
+
+1. Create new directory for mini app
+
+   ```bash
+   mkdir /opt/remnawave-telegram-sub-mini-app && cd /opt/remnawave-telegram-sub-mini-app
+   ```
+
+2. Download and configure the environment variables.
+
+   ```bash
+   curl -o .env https://raw.githubusercontent.com/maposia/remnawave-telegram-mini-bot/refs/heads/main/.env.example
+      ```
+
+3. Configure the environment variables.
+   ```bash
+   nano .env
+      ```
+   
+4. Create docker-compose.yml file
+
+   ```bash
+   nano docker-compose.yml
+      ```
+Example below.
+
+```yaml
+services:
+   remnawave-mini-app:
+      image: ghcr.io/maposia/remnawave-telegram-sub-mini-app:latest
+      container_name: remnawave-telegram-mini-app
+      hostname: remnawave-telegram-mini-app
+      env_file:
+         - .env
+      restart: always
+      # volumes:
+      #   - ./app-config.json:/app/public/assets/app-config.json
+      ports:
+         - '127.0.0.1:3020:3020'
+#      networks:
+#         - remnawave-network
+
+#networks:
+#   remnawave-network:
+#     name: remnawave-network
+#      driver: bridge
+#      external: true
+```
+
+Uncomment if you want to use your own template downloaded from the Remna panel.
+p.s. file must be placed in the same directory with this docker-compose file
+
+```yaml
+      volumes:
+        - ./app-config.json:/app/public/assets/app-config.json
+```
+
+Uncomment if you want to use local connection via single network in docker
+
+```yaml
+     networks:
+        - remnawave-network
+
+networks:
+   remnawave-network:
+     name: remnawave-network
+      driver: bridge
+      external: true
+```
+
+5. Run containers.
+   ```bash
+   docker compose up -d && docker compose logs -f
+   ```
+6. Mini app is now running on http://127.0.0.1:3020
+
+Now we are ready to move on the Reverse Proxy installation.
+
+
+<div style={{ display: 'flex', justifyContent: 'center', gap: '1rem' }}>
+  <Button label="Github repository" link="https://github.com/maposia/remnawave-telegram-sub-mini-app" variant="secondary" size="md" outline />
+</div>
+<br />
+
+<div style={{ display: 'flex', justifyContent: 'center' }}>
+  <img src="/awesome/remnawave-telegram-sub-mini-app.webp" alt="Remnawave Telegram Subscription Mini App" width="600" />
+</div>
+
+---
+
 ## Add project to the list
 
 If you want to add project to the list, please open a PR on [GitHub](https://github.com/remnawave/panel/blob/main/docs/awesome-remnawave/index.md).