Skip to Content
Welcome to the docs 🎉
Applications

Applications Overview

Byconvo consists of three main applications, each serving a specific purpose in the platform ecosystem.

Monolith (Rails Application)

Domain: app.byconvo.com
Technology Stack:

  • Ruby on Rails 8
  • Inertia.js 2.x (React adapter)
  • React 19.x with TypeScript
  • Vite 7.x for asset bundling
  • Tailwind CSS 4.x
  • SQLite database with local storage

Key Features

  • Modern Frontend: Inertia.js bridges Rails backend with React frontend
  • Component Library: Built with Radix UI and shadcn/ui patterns
  • Authentication: Custom identity management system
  • Job Processing: Solid Queue integrated with Puma
  • Asset Management: Vite for fast builds with React Compiler support

Technology Details

Backend:

  • Rails 8 with SQLite database
  • Solid Queue for background jobs (runs in Puma process)
  • Action Cable for WebSocket support
  • Active Storage for file uploads

Frontend:

  • React 19.2.3 with TypeScript 5.9
  • Inertia.js for SPA-like experience
  • Vite 7.3 with Ruby plugin
  • Babel React Compiler for optimizations
  • Headless UI and Radix UI components
  • Lucide React icons
  • Tailwind CSS 4.1 with forms and typography plugins

Development Tools:

  • RuboCop for Ruby linting
  • ESLint with TypeScript support
  • Prettier for code formatting
  • Brakeman for security scanning
  • RSpec for testing

Package Manager

Uses pnpm 10.26.2 for JavaScript dependencies.

Deployment Configuration

service: monolith
image: rutenisr/monolith
host: app.byconvo.com
port: 80 (via Kamal proxy with SSL)
healthcheck: Rails /up endpoint

Environment Variables:

  • RAILS_MASTER_KEY: Encrypted credentials key
  • SOLID_QUEUE_IN_PUMA: Background job processing
  • Optional: SSR support via INERTIA_SSR_ENABLED

Volumes:

  • /rails/storage - Persistent storage for SQLite and Active Storage

Website (www)

Domain: byconvo.com, www.byconvo.com
Technology Stack:

  • Next.js 16.1.1 (App Router)
  • React 19.2.3
  • TypeScript 5.9.3
  • Tailwind CSS 4.1.18

Key Features

  • Marketing Site: Public-facing website
  • Server-Side Rendering: Next.js App Router for optimal SEO
  • Responsive Design: Tailwind CSS styling
  • Fast Development: Hot reload on port 4000

Technology Details

Framework:

  • Next.js 16.1 with App Router
  • Standalone output for Docker deployment
  • React 19.2.3
  • TypeScript 5.9.3

Styling:

  • Tailwind CSS 4.1 with PostCSS
  • Geist font family (Sans & Mono)

Development:

  • ESLint with Next.js config
  • Development server on port 4000
  • Production server on port 80

Package Manager

Uses pnpm 10.26.2 for dependencies.

Deployment Configuration

service: www
image: rutenisr/www
hosts:
  - byconvo.com
  - www.byconvo.com
port: 80 (via Kamal proxy with SSL)
healthcheck: /up endpoint

Documentation (docs)

Domain: docs.byconvo.com
Technology Stack:

  • Next.js 16.1.1 (App Router)
  • Nextra 4.6.1 (Docs Theme)
  • React 19.2.3
  • TypeScript 5.9.3

Key Features

  • Documentation Platform: Powered by Nextra
  • MDX Support: Write docs in Markdown with React components
  • Search: Built-in full-text search
  • Syntax Highlighting: Code blocks with LaTeX support
  • Dark Mode: Automatic theme switching

Technology Details

Framework:

  • Next.js 16.1 with Nextra plugin
  • Nextra Docs Theme 4.6.1
  • MDX components for content
  • Standalone output for Docker

Features:

  • LaTeX math rendering
  • Code block search disabled
  • Theme components from nextra-theme-docs

Development:

  • Development server on port 3001
  • Production server on port 80
  • TypeScript strict mode

Package Manager

Uses pnpm 10.26.2 for dependencies.

Deployment Configuration

service: docs
image: rutenisr/docs
host: docs.byconvo.com
port: 80 (via Kamal proxy with SSL)
healthcheck: /up endpoint

Common Infrastructure

All three applications share:

  • Docker Registry: Docker Hub (rutenisr/)
  • Server: Single VPS at 157.90.150.53
  • SSL/TLS: Let’s Encrypt certificates via Kamal proxy
  • Orchestration: Kamal 2.2.1
  • CI/CD: GitHub Actions
  • Architecture: AMD64 containers
IntroductionInfrastructure