Skip to main content

ItBuild Platform Documentation

Welcome to ItBuild - a comprehensive platform for building and deploying multi-tenant Progressive Web Applications with standardized modules and custom business logic.

What is ItBuild?​

ItBuild is a platform-as-a-service that enables rapid development and deployment of business applications using:

  • Standard Modules - Pre-built, maintained by ItBuild team

    • AuthProxy - Web server, 14 authentication methods, reverse proxy, file service, SSE/webhooks, MCP server, embedded STUN, inbound email bridge
    • TrexWallet - Cryptocurrency wallet, transactions, blockchain integration (5 scanners: Ethereum, Tron, Bitcoin, Binance, Monero, TON) plus the TrexWallet.Acquiring sidecar for Stripe / T-Bank acquiring
    • TrexWallet.Markets - Rate aggregation across 9 exchange / aggregator sources (Binance, Kraken, WhiteBit, Bitfinex, Huobi, Yobit, Bybit, Bestchange, CoinGecko)
    • Chat - SMS (5 providers), Email, Telegram bot, file metadata, feedback, WebRTC 1:1 calls (calls live in chat_mess, no separate video_calls table since 2026-04)
    • CRM - Customer management, referral system, user_exid_flags Verified / ManuallyAdded distinction (since 2026-05)
    • Hybrid Payment Gateway - Part of TrexWallet: universal /pay page in trexwallet.pwa with single switching point payment_order_start. Built-in Crypto / Internal / Stripe / T-Bank flows; custom P2P / card / wire flows live in customer Core, reached through tokens_networks.flow_path (the legacy standalone payment-gate.pwa was decommissioned in 2026-05)

  • Core Module - Your custom business logic

    • You control the source code
    • Implements your specific requirements
    • Integrates with standard modules

  • PWA Frontends - Modern web applications

    • Preact for AuthProxy (< 200KB - first load is critical)
    • React for other modules (< 500KB - feature-rich)
    • TypeScript, Vite, responsive design

Key Benefits​

For Your Business​

🚀 Fast Development

  • Reuse proven standard modules
  • Focus on your business logic
  • Skip infrastructure setup

💰 Cost Effective

  • No need to build authentication, messaging, etc.
  • Shared maintenance of standard modules
  • Predictable costs

🔒 Enterprise Security

  • 14 authentication methods (PassKey, FIDO2, OAuth, OTP, and more)
  • Rate limiting (per IP, session, and public key)
  • Comprehensive audit logging (IP, geolocation, device fingerprint)

📊 Scalability

  • Multi-tenant architecture
  • Horizontal scaling with session locality (no sync overhead)
  • DNS Round Robin → frontend probes → sticky sessions

For Developers​

🛠️ Modern Stack

  • .NET 10 backend
  • React/Preact frontend
  • TypeScript everywhere
  • Docker containerization

📚 Clear Architecture

  • Modular design
  • RESTful APIs with ApiResponse format
  • Minimal code philosophy
  • Comprehensive documentation

🔧 Full Control

  • Access to core module source code
  • Standard modules via API
  • Custom deployment options

⚡ Development Stability

  • Your development is decoupled from platform releases
  • Request builds when YOU need them
  • Mix different module versions freely
  • NO forced upgrades - upgrade on YOUR schedule
  • See: Versioning Strategy

Platform Architecture​

graph TB
    subgraph "Customer Project"
        A[AuthProxy] --> B[TrexWallet]
        A --> C[Chat]
        A --> D[CRM]
        A --> E[Core Module]

        B --> F[(SQL Server)]
        C --> F
        D --> F
        E --> F

        A --> G[PWA Frontends]
    end

    subgraph "AuthProxy Capabilities"
        H[14 Auth Methods]
        I[Reverse Proxy]
        J[File Service]
        K[SSE/Webhooks]
        L2[MCP Server]
        L3[Embedded STUN]
        L4[Inbound Email]
    end

    A --> H
    A --> I
    A --> J
    A --> K
    A --> L2

Module Capabilities​

ModuleKey Features
AuthProxyPassKey, FIDO2, OAuth (Google, Apple, Microsoft, GitHub, Facebook, VK, Discord, Telegram), Phone OTP, Email OTP, magic links, federation v2 manual provider picker, inter-service auth, SSE real-time events (capability mode), webhooks, MCP server for AI agents, embedded STUN responder, inbound email bridge
TrexWalletWallets, transactions, Ethereum / Binance / Tron / Bitcoin / Monero / TON scanners, hybrid Payment Gateway, multi-wallet lifecycle, events API
TrexWallet.AcquiringSidecar runtime for Stripe Checkout / T-Bank acquiring with reconciliation polling
TrexWallet.MarketsCross-exchange rate aggregation (9 sources), get_rates API, per-pair admin
ChatSMS (Twilio, Smsc, Infobip, Nexmo, SmsApi), Email, Telegram bot, file metadata, feedback, WebRTC 1:1 calls in chat_mess, widget messages, anonymous invite chats, capability SSE
CRMCustomer cards, referral codes, user_exid_flags Verified / ManuallyAdded

How It Works​

1. Create Your Project​

Register on ItBuild platform, create a project:

  • Choose project name
  • Specify your domain (e.g., app.yourcompany.com)
  • Select standard modules you need
  • Get assigned DEV environment

2. Verify Domain Ownership​

Add DNS TXT record to verify you own the domain:

_itbuild-verify.app.yourcompany.com  TXT  "{ProjectID}:{AppID}"

3. Develop Core Module​

Write your business logic:

  • Access to source code repository
  • Standard API patterns (ApiResponse format)
  • Integrate with ItBuild modules
  • Automated builds on git push

4. Test on DEV Environment​

Each customer project gets its own DEV port on the shared dev stand. The exact URL is assigned when the project is provisioned:

https://dev.itbuild.app:<your-project-port>

Customer ports are allocated from 8001-8999. The platform's own dev stand (used for platform-team smoke tests, not for customer testing) lives at https://dev.itbuild.app:8081 — do not confuse the two.

  • Automatic deployment on build.
  • Separate database.
  • Full functionality testing.
  • Monitoring and logs available.

5. Deploy to Production​

When ready for production:

  • Download deployment package
  • Deploy on your infrastructure
  • Or let ItBuild team assist

Multi-Tenant Architecture​

Each project is isolated:

  • Unique Domain - Your brand, your domain
  • Domain-Bound License - Modules only run on your verified domain
  • Separate Databases - Your data is isolated
  • Own Resources - Dedicated or shared VM
  • Custom Port - For DEV environment

Modules are built specifically for your verified domain and will only function on that domain.

Technology Stack​

Backend​

  • .NET 10 - Modern, high-performance
  • ASP.NET Core - Web API and Razor Pages
  • Dapper - Fast, lightweight ORM
  • SQL Server - Reliable data storage

Frontend​

  • Preact 10.28 (apg.pwa / AuthProxy) — 3 KB, ultra-fast loading for the first paint of the login shell
  • React 19 (chat.pwa, trexwallet.pwa, itbuild.app.pwa, customer PWAs) — rich ecosystem with Zustand stores
  • TypeScript — type safety, platform int64 ids stay as string end-to-end
  • Vite 5/6/7 — lightning-fast builds

Infrastructure​

  • Docker - Containerized deployment
  • OpenTelemetry - Distributed tracing
  • Uptrace - Centralized logging
  • Grafana + Zabbix - Monitoring

Quick Start​

Ready to get started?

  1. Platform Overview - Understand the platform architecture
  2. Getting Started Guide - Create your first project
  3. Real-time Events & MCP - SSE, Webhooks, AI integration
  4. Core Module Development - Build your business logic
  5. Platform Changelog - Release history and migration notes

Module Documentation​

Detailed documentation for each module:

ModuleDocsDescription
AuthProxydocs.authproxy.techWeb server, 14 auth methods, reverse proxy, file service, embedded STUN, inbound email
TrexWalletdocs.trexwallet.techCrypto wallet, transactions, 6 blockchain scanners, Acquiring sidecar, hybrid Payment Gateway
ChatChat, CallsSMS/Email/Telegram, files, feedback, WebRTC 1:1 calls (in chat_mess), widget messages
CRMCRM, FeaturesCustomer management, referral system, user_exid_flags Verified / ManuallyAdded

Platform Test Stand​

For platform testing and demos:

https://dev.itbuild.app:8081/

Note: Customer DEV environments use different ports (8001, 8002, etc.)

Support​

  • Documentation - This comprehensive guide
  • Technical Support - Contact ItBuild team
  • Community - Developer forums
  • GitHub - Issue tracking

Next Steps​

Choose your path:

For Business Decision Makers:

For Developers:

For DevOps: