Architecture & Technologies

This reference page is intended for advanced readers, developers, and contributors who want to understand how the Truckers Tool Linux (TTL) framework is organized.

Core Technologies

The application supports high performance, without delay, but remains safe when writing game configuration binary files. Here is the stack we use:

1. Frontend: Next.js 16 (React 19) — Built with a dynamic and reactive interface.
2. Styling: Tailwind CSS v4 — Sharp and responsive Glassmorphism design.
3. Backend API: Node.js & Express — The engine that handles rapid computer disk I/O operations.
4. Core Logic: @trucky/sii-decrypt-ts — Vital library to extract and repack SCS Engine codes.
5. Security Standard: TypeScript — Significantly ensures every save state parameter (Money, XP, Plate string) is free from typo errors (Type-Safe).

Filesystem Structure

If you dissect the repository source code from GitHub, you will find the following composition:

1. server/ (Backend Brain) All file manipulation logic and sii-decrypt reside here. This folder focuses on reading the player’s local hard drive.
   • routes/profiles.ts: Responsible for the Restoration system and Backup Creation (autosave.bak).
   • routes/save.ts: Injects the Money/Level values arriving from the web into the real game filesystem.
   • utils/parser.ts: Highly critical! This file is the Triple-Check System program that checks every curly brace Line block of the SII file is unbroken before Saving.
2. src/ (Frontend Face) The outer web part, the UI where users press buttons and view their profile graphs.
   • components/: Collection of Glassmorphism UI design elements (Cards, Buttons, Stat Compare Modals).
   • hooks/useApi.ts: Connecting script so the Web can call the Backend engine in real-time.
3. Execution Point
   • ttl.sh: The fast installation script of the Linux Bash Shell.