whatisgithub

What is mizban?

mberneti/mizban — explained in plain English

Analysis updated 2026-05-18

37TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A self-hosted, open-source alternative to Diawi for distributing iOS and Android test builds to testers over the air.

Mindmap

mindmap
  root((Mizban))
    What it does
      Distributes test builds
      Generates install manifests
    Tech stack
      React
      TypeScript
      Node.js
    Use cases
      iOS OTA distribution
      Android APK sharing
    Audience
      Mobile developers
      QA testers

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 build with it?

USE CASE 1

Distribute .ipa and .apk test builds to testers without a third-party upload service

USE CASE 2

Host a self-branded, unlimited-size app catalog testers can install straight from their phone

USE CASE 3

Automatically generate iOS OTA install manifests and Android download links from build files

What is it built with?

ReactTypeScriptViteTailwind CSSNode.js

How does it compare?

mberneti/mizbancosmosshadow/usechathotakus/opencode-visual-cache
Stars373737
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires HTTPS hosting and, for iOS, an Ad Hoc provisioning profile with tester UDIDs registered in advance.

Free to use, modify, and share, including commercially, as long as you keep the copyright notice (MIT license).

So what is it?

Mizban is a self-hosted tool that helps app developers share test builds of iOS and Android apps with testers, without relying on a third-party upload service like Diawi. Instead of uploading your app file to someone else's server and getting a temporary download link, you run Mizban on your own server, which keeps you in control of the files with no size limits and no links that expire. The way it works is simple. A developer drops finished app build files.ipa for iOS and .apk for Android, into specific folders. A script then reads each file to pull out its real app name, version number, unique identifier, and icon, and automatically builds the technical pieces needed for testers to install the app straight from their phone: an iOS manifest file that works with Apple's official over the air install method, and a direct download link for Android. A simple web page then shows all the available apps in a grid, lets a tester pick which version they want, and starts the install process for them. One important limitation is worth knowing for iOS. Apple only allows ad hoc test builds to install on devices whose unique identifiers were registered with the developer's Apple account before the app was signed and exported. Mizban cannot get around this Apple rule, since it only solves the separate problem of getting the already signed file onto a phone, not the underlying Apple restriction. The project is built with React, TypeScript, and Vite for the web interface, plus a set of Node.js tools for reading app package files at build time. The end result is a static website with no upload feature and no backend server, so publishing a new build is simply a matter of adding a file, rebuilding, and redeploying, which keeps the whole setup simple to host anywhere that supports HTTPS, a requirement since Apple will not allow installs over plain, unencrypted connections. There is no built in login system, so anyone with the site's address can see and install the listed apps unless the owner adds their own access restrictions. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me set up Mizban on my own server to distribute iOS and Android test builds
Prompt 2
Explain how Mizban generates the iOS itms-services manifest from an ipa file
Prompt 3
Walk me through configuring BASE_URL correctly so iOS installs work over HTTPS
Prompt 4
Show me how to add basic authentication in front of my Mizban deployment

Frequently asked questions

What is mizban?

A self-hosted, open-source alternative to Diawi for distributing iOS and Android test builds to testers over the air.

What language is mizban written in?

Mainly TypeScript. The stack also includes React, TypeScript, Vite.

What license does mizban use?

Free to use, modify, and share, including commercially, as long as you keep the copyright notice (MIT license).

How hard is mizban to set up?

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

Who is mizban for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.