Install Koi-Koi as an app
Last updated
Koi-Koi installs as an app straight from the browser, with no app store: on iPhone and iPad with Safari’s Add to Home Screen, and on Android, Windows, macOS, Linux and ChromeOS with the browser’s install option. The app opens from its own icon without the browser around it, practice works offline, and it updates itself.
Install Koi-Koi on your device
You can install it from any page of this site, this one included. Whichever page you start from, the app opens at the home page, where the game is. Browsers rename their menus now and then, so a label may differ slightly on your version.
iPhone and iPad
- Share
- Add to Home Screen
- Open as Web App: on
- Add
- In Safari, tap the Share button. In Safari on iOS 26 it is behind the ••• button next to the address bar.
- Scroll down and tap Add to Home Screen.
- Leave Open as Web App on, then tap Add.
Chrome, Edge and Firefox on iPhone and iPad offer Add to Home Screen in their Share menu too. The icon is called “Koi-Koi”, or こいこい when you add it from a Japanese page. The app keeps its own data, apart from Safari’s, so you sign in once more the first time you open it. Apps such as Instagram, Facebook and LINE open links in their own viewer, which cannot add apps: open the page in Safari first.
Android
| Browser | How to install |
|---|---|
| Chrome | Open the ⋮ menuAdd to Home screenInstall |
| Samsung Internet | Tap the install icon in the address bar, or open the menuAdd page toHome screen |
| Firefox | Open the menuInstall |
Installed from Chrome or Samsung Internet, the app shares the browser’s data, so you stay signed in. Touch and hold its icon for three shortcuts: practice against the computer, playing a friend and the rules.
Windows
| Browser | How to install |
|---|---|
| Edge | The … menuAppsInstall this site as an app |
| Chrome | The ⋮ menuCast, save, and shareInstall page as app |
In both, the install icon at the right of the address bar does the same in one click. The app opens in its own window and shares the browser’s data, so you stay signed in. Right-click its icon on the taskbar for the shortcuts: practice, playing a friend, the rules and the yaku.
Mac
- File
- Add to Dock…
- Add
In Safari 17 or later (macOS Sonoma and later), choose FileAdd to Dock… in the menu bar, then click Add. Koi-Koi then opens in its own window from the Dock. Like on iPhone, it keeps its own data, so you sign in once more. In Chrome and Edge on a Mac, install it as on Windows; that app shares the browser’s data.
Linux and ChromeOS
Chrome, Chromium and Edge install it as on Windows: from the install icon in the address bar or from the browser’s menu. On Linux the app then appears with your other applications. Firefox on a computer cannot install web apps, so use one of those browsers for the app, or keep playing in a Firefox tab.
Install from inside the game
In Chrome, Edge and Samsung Internet, and in Safari on iPhone, iPad and Mac, the game offers the install itself:
- Install Koi-Koi as an app, a link under the buttons on the home page;
- Install app in the account menu, once you are signed in;
- the Play as an app part of the About dialog;
- a Play Koi-Koi as an app panel in the lobby after your first finished game (Not now hides it for 30 days).
In Chrome, Edge and Samsung Internet they open the browser’s own install dialog. On iPhone, iPad and in Safari on a Mac they show the steps above, and in an app’s built-in browser they explain how to open the page in Safari or Chrome first. Inside the installed app, the About dialog says you are using the app instead.
What the app gives you
- Its own icon and window, without the address bar and tabs, so the table has more room.
- Practice against the computer without an internet connection (see Offline).
- Shortcuts on the icon for practice, playing a friend, the rules and the yaku (Android shows the first three). The rules and yaku shortcuts open the guide, beside the table on a wide screen, even during a match; during a match the other two are turned away with “Finish or leave this match first.”
- In Chrome and Edge, opening the app again brings its open window forward instead of starting over, so a game in progress carries on.
- The same game and account as in the browser: the same rooms, invite links and rankings, and nothing extra to download.
Offline
Once the app, or the home page in a browser, has been opened with a connection, the game, the card pictures and a short offline page are kept on the device. Without a connection you can then:
- open the app and practise against the computer;
- read the pages of this site you have opened there since first opening the game (up to the 60 most recent).
Other pages show the offline page instead. Online matches, signing in, rooms and rankings need a connection; while it is gone, the game says “You are offline. Online play resumes when you reconnect.”
Updates
There is no app store in between: the app is this website, so it updates itself. With a connection, each page is loaded fresh first, and the copy on the device is used only when the network does not answer. While the game is open, it checks for a new version when it starts, every hour while it is on screen, and when you return to it after 15 minutes without a check.
A new version never interrupts a game. On the home page or in the lobby, the notice “A new version of Koi-Koi is ready.” offers Reload; if you leave the app in the background there instead, it switches to the new version by itself. During a match or in a room, it waits.
Remove the app
Remove it the way you remove other apps on that device, for example by touching and holding its icon on a phone or tablet. Removing the app does not delete your account: your profile and rankings stay, and the game still works in the browser. On an iPhone or iPad, where the app keeps its own storage, an online match left unfinished in it cannot be resumed after that; its keys were only there.
Permissions and privacy
The app is the same website in its own window, so it collects nothing more than the site does. It asks for no permissions: no notifications, location, camera, microphone or contacts. The privacy page explains what the game stores and why.
Sources
- News from WWDC25: WebKit in Safari 26 beta. WebKit: Every site added to the Home Screen opens as a web app
- Saving a website as a web app on the iPhone Home Screen. MacRumors: The iOS 26 steps
- News from WWDC23: WebKit Features in Safari 17 beta. WebKit: Add to Dock on macOS
- What’s new in web apps (WWDC23). Apple: Web apps on the Mac
- WebKit bug 181849. WebKit Bugzilla: Why you sign in again in the app
- What does it take to be installable?. web.dev: Installing in Chrome and Edge
- Get things done quickly with app shortcuts. web.dev: App shortcuts