Skip to content

README.md

Latest commit

 

History

History
86 lines (62 loc) · 2.68 KB

README.md

File metadata and controls

86 lines (62 loc) · 2.68 KB

Til Bridge

Java Spring Boot React Flutter License

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.