olib-mobile

# 📚 Olib

<div align="center">

![Flutter](https://img.shields.io/badge/Flutter-02569B?style=for-the-badge&logo=flutter&logoColor=white)
![Dart](https://img.shields.io/badge/Dart-0175C2?style=for-the-badge&logo=dart&logoColor=white)
![AI Built](https://img.shields.io/badge/AI%20Built-🤖-purple?style=for-the-badge)
![Open Source](https://img.shields.io/badge/Open%20Source-❤️-green?style=for-the-badge)
![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)

**🤖 An open-source ebook reader built entirely with AI assistance**

**Third-party client • Frontend interface only • All data from external sources**

[Download](https://bookbook.space) • [Report Bug](../../issues) • [Request Feature](../../issues)

**English** | **[简体中文](README_ZH.md)** | **[日本語](README_JA.md)** | **[한국어](README_KO.md)**

</div>

---

> ⚠️ **Disclaimer**: Olib is an independent, open-source third-party client. It is NOT an official client and is not affiliated with any official service. This project only provides the frontend interface - all book data comes from external sources. Use at your own discretion.

## ✨ Features

| Feature | Description |
|---------|-------------|
| 📖 **Book Search** | Search books by title, author, ISBN, or keywords |
| 💾 **Offline Reading** | Download books for reading without internet |
| 🌙 **Dark Mode** | Eye-friendly reading experience |
| 🌍 **Multi-language** | Supports 16+ languages including English, 中文, 日本語, 한국어 |
| 🔐 **Multi-Account** | Switch between multiple accounts seamlessly |
| 🔗 **Multi-Domain** | Choose from multiple server lines |
| 🆓 **100% Free** | No ads, no subscriptions, no hidden costs |

## 🤖 AI-Built Project

This project was built **entirely with AI assistance**:
- Architecture design by AI
- Code implementation by AI
- UI/UX design by AI
- Documentation by AI

## 📱 Screenshots

<div align="center">
<i>Coming soon...</i>
</div>

## 🚀 Quick Start

### Prerequisites

- Flutter SDK 3.8+
- Android Studio / VS Code
- Android device or emulator

### Installation

```bash
# Clone the repository
git clone https://github.com/shiyi-0x7f/olib-mobile.git

# Navigate to project directory
cd olib-mobile

# Install dependencies
flutter pub get

# Run the app
flutter run
```

### Build APK

```bash
flutter build apk --release
```

## 🏗️ Project Structure

```
lib/
├── l10n/           # Localization files (16+ languages)
├── models/         # Data models
├── providers/      # State management (Riverpod)
├── routes/         # App navigation
├── screens/        # UI screens
├── services/       # API & storage services
├── theme/          # App theme configuration
└── widgets/        # Reusable components
```

## 🛠️ Tech Stack

- **Framework**: Flutter
- **State Management**: Riverpod
- **Local Storage**: Hive
- **HTTP Client**: http package
- **Localization**: 16+ languages

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (`git