caporro/sub2gram repository overview

⁠sub2gram

sub2gram is a minimalist HTTP API designed to collect email subscriptions from landing pages and deliver instant Telegram notifications — with zero friction and near-zero resource usage.

Built in pure Go with no external dependencies, it runs as a ~8MB container on a scratch base image. Each project gets its own endpoint via URL path and its own CSV file for persistence. Drop it on an ARM VM and forget about it.

⁠Features

• 📬 Instant Telegram notification on every subscription
• 🗂 Per-project CSV persistence — one file per project, auto-created
• 🌐 CORS support with configurable allowed origins
• 🪶 ~8MB image, ~6MB RAM idle — truly lightweight
• 🔒 No database, no runtime, no external dependencies
• 🖥 Built for linux/arm64

⁠Quick start

docker run -d \
  --name sub2gram \
  -p 8080:8080 \
  -v /opt/sub2gram/data:/data \
  -e TELEGRAM_TOKEN=your_bot_token \
  -e TELEGRAM_CHAT_ID=your_chat_id \
  -e CORS_ORIGINS="https://yoursite.com,https://anothersite.com" \
  caporro/sub2gram:latest

Then call it from your landing page:

fetch("https://your-server.com:8080/myproject", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "[email protected]", message: "I want early access" })
})

You'll receive a Telegram message instantly:

*myproject*
Email: `[email protected]`
Message: I want early access

⁠Configuration

⁠Source

github.com/caporro/sub2gram⁠