Merge pull request #33 from maposia:main

Added Awesome Subscritption Mini App

docs/awesome-remnawave/index.md

@@ -152,6 +152,121 @@ sudo bash -c "$(curl -sL https://github.com/DigneZzZ/remnawave-scripts/raw/main/
 
 ---
 
+### Remnawave Telegram Subscription Mini App
+
+This is a Telegram Subscription Mini App that allows users to view 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 Remnawave panel.  
+P.S. file must be placed in the same directory with this `docker-compose.yml` 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
+```
+
+1. Run containers.
+
+```bash
+docker compose up -d && docker compose logs -f
+```
+
+2. 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).