BTCPayServer Companion

Empowering Lunarpunk Commerce

Building Privacy-First Business Tools for the Decentralized Future

Paralelná Polis Košice | 2025

The Challenge

🔍 Limited Analytics

BTCPayServer lacks comprehensive financial reporting

📊 No Powerful Dashboard

Missing unified view of multi-store performance

🔌 C# Plugin Barrier

BTCPay plugins require C# expertise, limiting JS/TS developers

🏢 Enterprise Gaps

Missing tools for business operations

BTCPayServer Companion

BTCPayServer Companion

Open-source extension platform for BTCPayServer

JavaScript/TypeScript plugin ecosystem via Greenfield API

Cross-platform desktop app (Windows, Linux, macOS)

Core Capabilities

100%
Self-hosted
∞
Extensibility

Financial Analysis App

Powering Paralelná Polis Košice

Revenue Insights

  • Monthly/yearly comparisons
  • Payment method preferences
  • Customer behavior patterns

Impact

📈 Better insights

Improved financial visibility

⏱️ Timesaver

Automated reporting

Plugin Ecosystem

Security First

%%{init: {'theme':'dark', 'themeVariables': { 'fontSize': '14px'}}}%% graph TB subgraph VPN["Optional VPN / Private Network"] subgraph "Browser/Desktop App" UI[React Client Components] IDB[IndexedDB Plugins] RQ[React Query Cache] end subgraph "Next.js Server" SA[Server Actions] ENV[.env Variables] SEC[Secure Storage] API[API Key - Never Exposed] end subgraph "Tauri Runtime" TAURI[Native APIs] FS[File System] end subgraph "Plugin System" PM[Plugin Manager] PS[Plugin Sandbox] PH[Plugin Hooks] end subgraph "External" BTC[BTCPayServer] GF[Greenfield API] WH[Webhooks] end end UI -->|Calls| SA UI -->|Settings Page| SEC SA -->|Reads| ENV SA -->|Reads| SEC ENV -->|Can contain| API SEC -->|Can contain| API SA -->|HTTP Requests| GF GF -->|Part of| BTC BTC -->|Optional events| WH WH -->|Can trigger| SA UI -->|Manages| PM PM -->|Stores in| IDB PM -->|Runs in| PS PS -->|Executes| PH PH -->|Request data via| SA UI -->|Desktop only| TAURI TAURI -->|Access| FS UI -->|Caches data| RQ style API fill:#ff4444 style ENV fill:#f7931a style SEC fill:#f7931a style SA fill:#6b46c1 style PS fill:#6b46c1 style TAURI fill:#22c55e classDef vpnBg fill:#0a0a0a80,stroke:#6b46c1,stroke-width:1px,stroke-dasharray: 8 4 classDef subgraphPadding fill:#1a1a2e,stroke:#333,stroke-width:1px,rx:5,ry:5 class VPN vpnBg

Zero-trust design

  • 🔐 API keys never leave server/PC
  • 🛡️ Server-side validation
  • 🚫 No tracking
  • 🔒 Encrypted local storage (WIP)
  • ✅ Full audit logging (WIP)

Modern Tech Stack

  • Next.js 15 - Server components
  • TypeScript - Type safety
  • React Query - Data synchronization
  • Tauri v2 - Cross-platform native apps (Win/Linux/MacOS)
  • Greenfield API - BTCPayServer integration
  • Webhooks - Real-time event handling

The Vision

WordPress for Bitcoin Commerce

Web-based plugins connecting via API & webhooks

Community Powered

Phase 1: Core platform
Phase 2: Plugin API (Current)
Phase 3: Marketplace (First apps by us)
Phase 4: Ecosystem growth

Let's Build the Ecosystem Together

Ways to Contribute

💻 Code

Build plugins, fix bugs, add features

📝 Documentation

Guides, tutorials, translations

🎨 Design

UI/UX improvements, themes

🧪 Testing

Report bugs, test features

Roadmap 2025

Plugin API

Stable plugin development framework

Marketplace Beta

Community plugin repository

Integrations

Signal / Telegram / Slack / Matrix / etc.

Mobile Apps

iOS/Android companion apps

Live Demo

Link to BTCPayServer Companion
+ MacOS app

Be Part of the Revolution

🌙 Embrace the Lunarpunk ethos

🛠️ Build privacy-first commerce tools

🌍 Create a decentralized future

GitHub: github.com/ParalelnaPolisKE/btcpayserver-companion

Contact: hello@michaltakac.com

Thank You

Questions? Donations?

BTC

XMR

Made with 🧡 at Paralelná Polis Košice