git404hub

what is hanairo fr?

youshen2/hanairo — explained in plain English

Analysis updated 2026-05-18

18SwiftAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

An unofficial SwiftUI iOS client for browsing, searching, and bookmarking artwork on Pixiv, with secure login and automatic token refresh.

vibe map

mindmap
  root((repo))
    What it does
      Unofficial Pixiv client
      Native SwiftUI app
    Features
      Rankings and search
      Bookmarks and follows
      Secure login
    Tech stack
      Swift
      SwiftUI
      Xcode
    Platforms
      iOS
      macOS
      visionOS
    Build
      Xcode project
      Unsigned IPA script

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

what do people make with this?

VIBE 1

Browse Pixiv illustrations and comics on iPhone with a native SwiftUI interface

VIBE 2

Check daily, weekly, and monthly popularity rankings for artwork

VIBE 3

Follow artists and browse their full works list with bookmarking and sharing

VIBE 4

Build and distribute your own unsigned iOS build with automatic Telegram release notifications

what's the stack?

SwiftSwiftUIXcodeGitHub Actions

how it stacks up fr

youshen2/hanairodanielou1208/agentslatepolamgh/azaditunnel
Stars181818
LanguageSwiftSwiftSwift
Setup difficultymoderatemoderatehard
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Xcode and a Pixiv account to log in, Telegram release publishing needs separate bot credentials.

in plain english

Hanairo is an unofficial app for browsing Pixiv, the Japanese art and comic sharing site, built for iPhone and other Apple devices using SwiftUI and following what the developer calls a liquid glass design style. It is not made or endorsed by Pixiv itself, just an independent client that talks to Pixiv's own service. Inside the app you can see recommended illustrations and comics, browse daily, weekly, monthly, and historical popularity rankings, follow public bookmarks and the activity of people you follow, search by popular tags, artwork, or user, and open multi page artwork with full detail including tags, author information, statistics, and related works. Viewing full size images supports double tap and pinch to zoom along with swiping between pages, and a floating action bar lets you bookmark, share, or download the original image. You can also view an artist's profile, follow them, and browse their full works list, along with general bookmarking, following, sharing, and content filtering features. The app requires you to log in before you can reach the main interface at all, using Pixiv's own secure browser based login flow, and it keeps you signed in afterward by storing your login token securely and refreshing it automatically, including retrying automatically if a request fails due to an expired session. The code is organized into clear layers: one part handles the app's screens and navigation, a components folder holds reusable SwiftUI pieces, and a core folder separates data models, networking and login code, secure token storage, and background services from each other, so each view only worries about what it shows on screen while requests and login state live in dedicated central places. To build it yourself you open the project in Xcode and run it, and it currently compiles for iPhone, Mac, and Apple Vision Pro. There is also a script for producing an unsigned iOS install file, and the project's automated build system can post each new build, along with a summary of recent changes, to a Telegram channel if you provide the right bot credentials. Because Pixiv's mobile interface is not an official public API, the developer notes that the networking code may need updates whenever Pixiv changes it on their end. The project takes inspiration from an existing Flutter based Pixiv client and is released under the Mozilla Public License 2.0.

prompts (copy fr)

prompt 1
Help me build and run Hanairo in Xcode targeting iOS.
prompt 2
Explain how Hanairo's PKCE login flow with Pixiv works.
prompt 3
Show me how to set up the Telegram CI publishing secrets for this project.
prompt 4
Walk me through the folder structure separating networking, auth, and UI in this app.
prompt 5
Help me set up the build_ios_unsigned.sh script to produce an unsigned IPA.

Frequently asked questions

what is hanairo fr?

An unofficial SwiftUI iOS client for browsing, searching, and bookmarking artwork on Pixiv, with secure login and automatic token refresh.

What language is hanairo written in?

Mainly Swift. The stack also includes Swift, SwiftUI, Xcode.

How hard is hanairo to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is hanairo for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.