English • Русский

💎 Prisma

A modern, next-generation cross-platform client for Booru imageboards and Creator archives
Smooth Pinterest-style masonry feed, Pawchive 2.0 two-way synchronization, intelligent in-app updates, dynamic aspect ratio detection, and buttery-smooth media playback.

---

🚀 What's New in Prisma 3.5

🎨 Design 2.0 & Interface Optimization

• Modern Visual Style: Squircle cards, adaptive dynamic Material You color palette, and refined glassmorphic surfaces.
• Intelligent Action Dock 2.0: Compact quick-action dock placed beneath posts for one-tap downloading, sharing, tag inspection, and source viewing.
• Smooth Animations & Micro-Interactions: Hero media transitions, interactive drag gestures, and animated double-tap likes.
• Keyboard-Adaptive Layout: Floating action buttons and navigation dock automatically minimize when the on-screen keyboard appears; search lists support dismiss-on-scroll.

🐾 Deep Pawchive 2.0 Integration

• Flexible Authentication: Sign in via username/password or direct Session Cookie.
• Two-Way Synchronization: Automatically synchronize your favorites between Prisma's local database and your Pawchive account. Local creators can be pushed to the server with a single tap.
• Instant Cloud Sync: Favoriting any creator across Patreon, Fanbox, Fantia, Boosty, Gumroad, DLsite, or Discord synchronizes with the server in real-time.

🎬 Smart Media Player & Dimension Detection

• Lazy Dimension Resolution: Instant 1920×1080 (and custom) aspect-ratio discovery without needing to pre-download large media files.
• Fullscreen Auto-Orientation: Video player automatically adjusts screen orientation (landscape or portrait) to match the media's native aspect ratio.

📦 Split APKs & ABI-Aware Auto-Updates

• Optimized per-ABI APK builds (arm64-v8a, armeabi-v7a, x86_64) for drastically reduced package sizes.
• Built-in update engine automatically detects the device CPU architecture and fetches only the required binary.

---

📚 Documentation & User Guides

Comprehensive illustrated documentation is available in the Prisma Wiki:

• 🚀 Getting Started & Installation — Selecting the proper APK for your device architecture, running on Linux, Windows, or macOS.
• 🌐 Content Providers — Using Booru sources (Gelbooru, Rule34, Realbooru, e621) and Pawchive creator archives.
• 🔍 Smart Search & Tags — and operators, syntax modifiers, and 0 ms autocomplete.
• 🐾 Pawchive Integration — Login, session cookies, two-way sync, and creator cloud exports.
• 🎬 Media Viewer & Player — Gesture navigation, automatic rotation, and Action Dock 2.0.
• 💾 Offline Mode & Downloads — Sync Hub, directory naming templates, and original quality preservation.
• 🛡️ Safety & Blacklist — Custom blacklist rules, Safe Mode, and cache management.
• ❓ Frequently Asked Questions (FAQ) — Troubleshooting, updater, audio playback, and common solutions.

---

✨ Key Features

• 📱 Pinterest-Style Masonry Feed: Staggered grid layout with instant mode switching (Masonry, 1:1 Square Grid, Compact List).
• 💾 Offline 2.0 & Sync Hub: Browse saved media directly from local storage with zero network requests, storage analytics, and batch export.
• 🔍 Search 2.0: Instant tag autocomplete, multi-tag queries with and, and modifiers such as type:video or rating:safe.
• 🛡️ Advanced Blacklist / Whitelist: Filter undesirable content by tags, categories, age ratings, or minimum score thresholds.
• 📁 Smart Download Manager: Flexible directory and filename templates ({Artist}, {Provider}, {Service}, {ID}, {Date}).
• 🌑 AMOLED Pure Black: True deep black background optimized for OLED/AMOLED display power efficiency.

---

🌐 Supported Providers

Provider	API Type	Supported Content
Pawchive	REST API v1	Patreon, Pixiv Fanbox, Fantia, Boosty, Gumroad, DLsite, Discord
Gelbooru	JSON / XML API	Anime artworks, tag taxonomy, creator profiles, ratings
Rule34	Booru API	Expansive booru database, animated WebM/MP4 and GIF
Realbooru	Scraper / API	Cosplay photography and realistic media
e621 / e926	REST JSON API	Furry and anthropomorphic art with granular tag search

---

📥 Downloads & Releases

Pre-compiled production releases are available on the GitHub Releases page.

Platform	Architecture	Format	Notes
Android	arm64-v8a	.apk	Recommended for all modern 64-bit Android smartphones
Android	armeabi-v7a	.apk	Legacy 32-bit Android devices
Android	x86_64	.apk	Android emulators, Chromebooks & x86 tablets
Linux	x86_64	.tar.gz	Portable standalone package for Linux distributions
Windows	x64	.zip	Portable release for Windows 10 & 11
macOS	Universal	.zip	Portable build for macOS

---

🛠️ Building from Source

Prerequisites

• Flutter SDK: >= 3.22.0 (Dart >= 3.4.0)
• Android SDK: Build-Tools & Platform-Tools (for Android targets)
• Linux: clang, cmake, ninja-build, pkg-config, libgtk-3-dev
• Windows: Visual Studio 2022 with "Desktop development with C++"
• macOS: Xcode 15+

Quick Start

# Clone repository
git clone https://github.com/RarDog/Prisma.git
cd Prisma

# Fetch dependencies
flutter pub get

# Run static analysis and tests
flutter analyze
flutter test

# Launch in debug mode
flutter run

Building Release Packages

# Android (Split APKs by ABI)
flutter build apk --release --split-per-abi

# Linux (Desktop bundle)
flutter build linux --release

# Windows (Desktop bundle)
flutter build windows --release

# macOS (Desktop bundle)
flutter build macos --release

---

🏛️ Project Architecture

lib/
 ├── app/               # Routing (GoRouter), theme configuration, l10n (EN/RU), animations
 ├── backend/
 │    ├── di/           # Riverpod dependency injection & providers
 │    ├── models/       # Post, ArtistProfile, PawchiveAccount, AppSettings
 │    ├── providers/    # API integrations (Gelbooru, Rule34, Pawchive, e621)
 │    ├── repositories/ # Local Isar database storage & cache layer
 │    └── services/     # Core services: PawchiveSync, Feed, Search, Downloads, Updates
 ├── core/              # Network client (Dio), database engine, utilities
 ├── features/          # Feature screens: feed, post, artists, favorites, settings
 └── shared/widgets/    # Reusable UI components (PostCard, MasonryGrid, Dock)

---

🔒 Privacy & Security

• 100% On-Device Storage: Your browsing history, bookmarks, favorite creators, and credentials stay strictly on your device.
• Zero Telemetry: No background tracking, no third-party analytic SDKs, and no user profiling.
• Direct Network Requests: Communication occurs directly between your client and selected provider endpoints without intermediary proxies.

---

👥 Authors & Credits

Authors: RarDog & Antigravity (Gemini)