feat: add initial localization support with Weblate

.github/CONTRIBUTING.md

@@ -14,6 +14,7 @@ Thank you for your interest in contributing to Kover. This document outlines the
     - [Examples](#examples)
   - [Reporting Issues](#reporting-issues)
   - [Requesting Features & Enhancements](#requesting-features-enhancements)
+  - [Localizations](#localizations)
   - [Developing Kover](#developing-kover)
     - [Codebase Overview](#codebase-overview)
     - [Architecture](#architecture)
@@ -73,6 +74,13 @@ If an idea is not yet clearly defined, consider starting a discussion instead of
 
 ---
 
+## Localizations
+
+Localization contributions are also very welcome and a great way to contribute to Kover. A Weblate project is available
+to anyone interested in increasing Kover's language support. To get started, please visit the project on [Weblate](https://hosted.weblate.org/engage/kover/)
+
+---
+
 ## Developing Kover
 
 ### Codebase Overview
@@ -134,6 +142,8 @@ graph LR
 - Avoid manually modifying generated code.
 - Avoid violating the architecture layer boundaries.
   - For example, UI code should not directly access the database or API, but rather go through providers and managers.
+- New text strings exposed in the UI should be added to the English localization file `lib/l10n/en.arb` and accompanied by a description for the string in
+  the respective `@` entry. No other localization files should be manually edited as those are managed through Weblate.
 
 ### Setting Up Your Development Environment
 

.github/workflows/ci.yaml

@@ -52,7 +52,9 @@ jobs:
         run: cd macos && fastlane disable_codesign
 
       - name: Code Generation 🧬
-        run: dart run build_runner build --delete-conflicting-outputs
+        run: |
+          dart run build_runner build --delete-conflicting-outputs
+          flutter gen-l10n
 
       - name: Validate DB Schema 🗄️
         if: matrix.platform != 'windows'

.gitignore

@@ -54,6 +54,7 @@ app.*.map.json
 *.g.*
 *.freezed.dart
 /lib/api
+/lib/generated
 # openapi.json
 
 # local environment 

README.md

@@ -3,6 +3,11 @@
 
 # Kover
 
+[![CI](https://github.com/rodonisi/kover/actions/workflows/ci.yaml/badge.svg)](https://github.com/rodonisi/kover/actions/workflows/ci.yaml)
+[![Build & Deploy](https://github.com/rodonisi/kover/actions/workflows/build-and-deploy.yml/badge.svg)](https://github.com/rodonisi/kover/actions/workflows/build-and-deploy.yml)
+<a href="https://hosted.weblate.org/engage/kover/"><img src="https://hosted.weblate.org/widget/kover/kover/svg-badge.svg" alt="Translation status"></a>
+![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/rodonisi/kover/total)
+
 An unofficial cross-platform [Kavita](https://www.kavitareader.com/) client.
 
 </div>
@@ -114,3 +119,17 @@ To connect Kover to a Kavita instance:
   <img src="screenshots/settings2.png" alt="Screenshot" width="220" />
   <img src="screenshots/settings3.png" alt="Screenshot" width="220" />
 </p>
+
+## Thanks
+
+<p align="center">
+  <a href="https://sentry.io">
+    <img src="./docs/assets/sentry.svg" height="50" width="169" alt="Sentry" />
+  </a>
+  <a href="https://weblate.org">
+    <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/6/69/Weblate_logo.svg/1280px-Weblate_logo.svg.png" height="50" alt="Weblate" />
+  </a>
+</p>
+
+- [Sentry](https://sentry.io/) for providing an open source license for their error reporting software.
+- [Weblate](https://weblate.org/) for providing free hosting to support translations.

l10n.yaml

@@ -0,0 +1,4 @@
+arb-dir: lib/l10n
+output-dir: lib/generated/l10n
+template-arb-file: en.arb
+nullable-getter: false