Hash Studios 开源壁纸应用 Prism：Flutter 打造，支持 AI 生成壁纸

Prism is an open-source wallpaper app for Android and iOS, built with Flutter and Dart by Hash Studios.

Google Play · Releases · Changelog · Contributing

Features

• Browse community wallpapers, Wallhaven, and Pexels, with a personalized home feed and a Wall of the Day.
• Search by keyword, color, or tag, with filters and recent searches. Open "More like this" to find similar wallpapers.
• Browse categories and collections, and follow creators.
• Save favourites to your account, then sort, filter, search, and select many at once. Share or delete many downloads at once.
• Preview wallpapers with a clock overlay. Set them with Fill or Fit, crop them, or pick a default target on supported platforms.
• Make any wallpaper move, pick a living gradient, or use a video as a live wallpaper (Android).
• See the wallpapers you set before and set them again.
• Edit wallpapers with stacked filters, blur, hue, saturation, and brightness controls.
• Upload wallpapers for review and track their approval status.
• Generate AI wallpapers from text prompts, create variations, and share the results.
• Earn Prism Coins through rewarded ads and daily rewards, and spend them on supported actions.
• Read notifications in an inbox with unread marks, and set preferences in one sheet.
• Customize the app's theme and accent, and manage cached images and downloads.
• Rotate favourites or downloads on a timer, only while charging or in set hours, with Prism Pro on Android.

Platform capabilities vary. Android supports home-screen and lock-screen wallpaper actions. iOS supports saving images for manual application. Premium access and coin costs depend on the action. The app shows the applicable gate before proceeding.

See docs/features for a short page on each feature.

Repository layout

The app uses BLoC, freezed, get_it/injectable, and auto_route. See architecture guidance for feature structure. Dependency versions live in pubspec.yaml, functions/package.json, and web/package.json.

Development setup (FVM)

Install FVM, Make, and a POSIX shell. Android development needs the Android SDK. iOS development needs macOS, Xcode, and CocoaPods.

Clone the repository

Use a shallow, single-branch clone when you do not need old commit history:

git clone --depth 1 --single-branch https://github.com/Hash-Studios/Prism.git

Use a single-branch blobless clone when you need commit ancestry but can fetch file contents on demand:

git clone --filter=blob:none --single-branch https://github.com/Hash-Studios/Prism.git

A full clone fetches every branch, including qa/screenshots, and historical binaries. Sparse checkout limits files in your working tree, but does not avoid fetching history. Fetch another branch when you need it:

git fetch origin branch-name:refs/remotes/origin/branch-name

Keep tracked files at or below 1 MiB. Store APK, AAB, and IPA release files on GitHub Releases. Run make repo-assets-check to check tracked files before opening a pull request; make ci runs the same check.

From the repository root, run:

make setup
fvm flutter doctor -v

make setup installs and selects the Flutter SDK pinned in .fvmrc, then resolves app dependencies. On macOS, it also prepares iOS pods. Use fvm flutter and fvm dart for subsequent SDK commands. Prism's Flutter app needs a mobile device, emulator, or simulator. The separate Next.js website runs in a browser.

Local checks without service access

A fresh checkout has no lib/firebase_options.dart. Create the ignored stub for local analysis and tests:

tool/write_firebase_options_stub.sh
make format-check
fvm flutter analyze --no-pub --no-fatal-infos
make test

The stub script preserves an existing real Firebase options file. Do not commit Firebase configuration files. For a UI-only debug run without Doppler or Firebase access, use:

fvm flutter run --dart-define=SKIP_FIREBASE_INIT=true

Firebase-backed feeds, sign-in, notifications, and rewards need real development service configuration. A run that skips Firebase does not verify those features.

Secrets with Doppler

Runtime secrets come from Doppler, using project prism and local configuration dev. .env.example lists key names for reference. Make targets do not load it as a runtime secrets file.

Obtain development service access and Firebase configuration from a maintainer. The app needs matching local files:

• lib/firebase_options.dart
• android/app/google-services.json
• ios/Runner/GoogleService-Info.plist

Replace any Firebase stubs before a service-backed run. Install the Doppler CLI, then run:

make doppler-login
make setup-dev
make run

make run injects Dart defines from Doppler. If the Android Google Services file is absent, it skips Firebase initialization, including on iOS. See the Doppler workflow for access checks, secret updates, and troubleshooting. The contribution guide covers configuration for your own development Firebase project.

Common development commands

Run these commands from the repository root:

The local app gate also needs Node.js 22.6 or newer for worker tests. Functions, website, and Firestore rules checks run separately. See Contributing for their commands and UI verification requirements. web/README.md covers website development, and infra/cloudflare/README.md covers the worker.

GitHub CI runs on pull requests that are ready for review and selects jobs by changed paths. Draft PRs skip the checks. The required ci check aggregates app, functions, website, and rules results. See the CI workflow.

Contributing

Read CONTRIBUTING.md before submitting a change. Open a focused PR against master with the linked issue and verification results. Report bugs through the issue templates.

Support

Contact Hash Studios at hash.studios.inc@gmail.com, join the Telegram community, or follow Prism Wallpapers. You can support development through Buy Me a Coffee. See the contributors who maintain Prism.

License

Prism uses the BSD 3-Clause License.

Privacy

Read PRIVACY.md for data collection and third-party services.