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)

---

⚠️ Disclaimer & Vibe Coding

Note

This project is 100% vibe coding built in tandem with an AI coding partner. I have zero background in Dart and Flutter — this project is built for personal use out of pure enthusiasm.

Although every build is personally and thoroughly tested in daily use before being published, the codebase may still contain quirks, bugs, or sub-optimal patterns. This is a passion project built for personal fun and convenience, which means development could slow down or be abandoned at any moment without prior notice. Community contributions, advice, and pull requests are always welcome!