Skip to content

Frontend Stack

The frontend is built on SolidJS, avoiding unnecessary React abstractions to ensure small bundle sizes, fast hydration, and fine-grained reactivity. The entire project is written in TypeScript for long-term maintainability and type safety.

This stack is optimized for Telegram Mini Apps, high-performance mobile UIs, and TON-based payments.

Core Framework

  • solid-js – Reactive UI framework with fine-grained reactivity (no virtual DOM).
  • @solidjs/router – Client-side routing for Mini App navigation.
  • solid-transition-group – Animated view/page transitions.
  • solid-devtools (dev) – Debugging and reactive graph inspection.

State, Data & Performance

  • @tanstack/solid-query – Server state management, caching, and background refetching.
  • @solid-primitives/scheduled – Frame/timeout/task scheduling utilities.
  • @nozbe/microfuzz – Fast client-side fuzzy search.

Telegram & TON Integration

  • @telegram-apps/sdk-solid – Telegram Mini Apps API bindings and lifecycle events.
  • twallpaper – Telegram-style animated wallpapers and backgrounds.
  • @tonconnect/sdk – TON wallet connection layer.
  • @tonconnect/ui – Prebuilt TON wallet modal & UI components.

Animations & Visual Effects

  • lottix – Render Lottie / TGS animations (gzip → JSON inflation).
  • animate.css – Predefined CSS animations.
  • solid-transition-group – UI transitions & enter/exit effects.

UI, Gestures & Interaction

  • swiper – Sliders, carousels, tab views.
  • pulltorefreshjs – Native-like pull-to-refresh gesture.
  • @types/pulltorefreshjs – Type definitions for TypeScript.
  • solid-icons – Icon packs optimized for Solid.
  • solid-toast – Toasts & user notifications.

Date, IDs & Utilities

  • dayjs – Lightweight date/time formatting.
  • uuid – Unique ID generation.
  • plausible-tracker – Custom event & analytics tracking (server-side friendly).

Internationalization

  • @solid-primitives/i18n – Multilingual support with reactive translations.

Styling System

  • Tailwind CSS – Utility-first design system.
  • @tailwindcss/vite – Native Vite integration.
  • SCSS (sass) – Advanced styling & variables.
  • postcss – CSS transformation pipeline.
  • autoprefixer – Cross-browser CSS compatibility.
  • postcss-reporter – CSS lint/error reporting.

Tooling & Build

  • Vite – Ultra-fast bundler and dev server.
  • vite-plugin-solid – SolidJS compiler & HMR.
  • vite-plugin-solid-svg – Import SVGs as Solid components.
  • vite-plugin-purgecss – Removes unused CSS in production.
  • Biome – Unified formatter + linter.
  • TypeScript – Static typing across the codebase.

Why This Stack Works for Telegram Mini Apps

  • Mobile-first performance (SolidJS + Vite)
  • Native Telegram UX (twallpaper, pull-to-refresh, swiper)
  • TON-ready (TonConnect SDK + UI)
  • Scales to large datasets (virtual lists + query caching)
  • Production-grade tooling (Biome, PurgeCSS, Devtools)