gitwtfhub

wtf is vnclient?

sunxibing114514/vnclient — explained in plain English

Analysis updated 2026-05-18

20DartAudience · generalLicense

TL;DR

An unofficial Flutter mobile app that mirrors the VNDB visual novel database, letting you browse, search, and manage your personal visual novel collection.

Mindmap

mindmap
  root((VNclient))
    What it does
      Unofficial VNDB client
      Visual novel browsing
      Personal collection lists
    Tech stack
      Flutter
      Dart
      Riverpod
    Use cases
      Browse new releases
      Track ratings and wishlist
      Search personal lists
    Audience
      Visual novel fans
      General mobile users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Browse new visual novel releases and recent database changes from your phone.

REASON 2

Look up a visual novel's developer, staff, characters, and release editions.

REASON 3

Track your own collection using rated, wishlist, and all-titles list tabs.

REASON 4

Search within your personal visual novel lists.

What's in the stack?

FlutterDartRiverpodGo RouterDio

How it stacks up

sunxibing114514/vnclientl930203811/zenfiledevemberteam-ops/pyre
Stars201817
LanguageDartDartDart
Setup difficultyeasyeasy
Complexity2/52/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

Wtf does this do

VNclient is a mobile app built with Flutter that acts as an unofficial companion for VNDB, the Visual Novel Database website. It recreates the site's features using a modern Material Design 3 look, and the author notes that part of the code was generated with AI help. On the home screen it shows the newest releases, a random pick, and recent changes on VNDB. Tapping into a visual novel shows full details such as its developer, publisher, tags, cast of characters, staff credits, screenshots, and release editions. You can tap on a developer or publisher to see everything else they have worked on, and staff members are grouped by role, such as writing, art, music, or voice acting, with sections you can expand or collapse. There is also a page listing every visual novel a particular staff member contributed to. The app lets you manage your own visual novel collection through list tabs for everything you track, your ratings, and your wishlist, plus a search feature that works within your personal lists. It supports both Simplified Chinese and English, follows Material You accent color customization, and switches between light and dark mode automatically based on your phone's system setting. Under the hood it is built with Flutter, using Riverpod for state management, Go Router for navigation, Dio for network requests, and Flutter Secure Storage to keep login details safe on the device. It pulls its data from the official VNDB Kana API, and login is handled through an API key stored locally. Getting it running requires the Flutter SDK, the Android SDK for building an Android app, and a VNDB account for any feature that needs a login. It is released under the Apache-2.0 license.

Yoink these prompts

Prompt 1
Explain how VNclient organizes its features folder for the home, search, and lists screens.
Prompt 2
Show me how the VNDB Kana API key is stored and used for login in this app.
Prompt 3
Help me set up the Flutter and Android SDK requirements to build VNclient.
Prompt 4
How does this app switch between Simplified Chinese and English localization?

Frequently asked questions

wtf is vnclient?

An unofficial Flutter mobile app that mirrors the VNDB visual novel database, letting you browse, search, and manage your personal visual novel collection.

What language is vnclient written in?

Mainly Dart. The stack also includes Flutter, Dart, Riverpod.

Who is vnclient for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.