Til Bridge

Til Bridge is a professional software suite designed for transliterating the Kazakh language between Cyrillic and Latin scripts. The project provides a unified solution across web and mobile platforms, backed by a robust RESTful API.

---

Project Structure

The repository is organized into three specialized modules:

Module	Technology Stack	Description
til-bridge-backend	Spring Boot 3.2	Core REST API, Transliteration Logic, H2 Database
til-bridge-react	React + TypeScript	Modern Web Interface with Responsive Design
til-bridge-ui	Flutter	Cross-platform Mobile Client (Android/iOS)

---

Key Features

• Bidirectional Transliteration: High-accuracy conversion between Kazakh Cyrillic and Latin scripts.
• Open Access: Public service with no mandatory authentication or registration.
• Session Management: Local history tracking for persistent user data across sessions.
• Native Performance: Dedicated Flutter application for optimal mobile experience.
• DevOps Ready: Integrated health monitoring, structured logging, and Docker support.

---

App Name

Download

Download APK

How to install

1. Download APK
2. Allow "Install from unknown sources"
3. Install

Quick Start

Backend (Spring Boot)

Ensure Java 17+ is installed.

cd til-bridge-backend
./mvnw spring-boot:run

API accessible at: http://localhost:8080/api/v1

Web Frontend (React)

Requires Node.js 18+.

cd til-bridge-react
npm install
npm start

Web application runs at: http://localhost:3000

Mobile Application (Flutter)

Requires Flutter SDK.

cd til-bridge-ui
flutter pub get
flutter run

---

Configuration

System parameters can be configured in til-bridge-backend/src/main/resources/application.properties:

• Network: server.port (Default: 8080)
• Security: cors.allowed.origins (CORS policy for frontend clients)
• Engine: libretranslate.api.url (Primary transliteration engine)

---

License

This project is licensed under the MIT License.