Minimum functionality
Apple expects features, content or UI beyond a repackaged website. Call native features from the web app through the bridge, and test them on a real iPhone.
iOS builds: planned, not available yet
html2app wraps your web build in a Flutter app and shows it in a WebView. Android builds run on Windows, Linux and macOS. An IPA can only be built on macOS with Xcode, so the iOS path needs a Mac. This page shows the workflow, the build costs, and the Flutter code inside the shell.
iOS is not available yet. Android builds are live now.
The Flutter code is the same for both platforms. Only the IPA build step needs macOS.
01 Workflow
You write and test on the Mac mini. The build server turns the upload into an .ipa. App Store Connect delivers it to your iPhone through TestFlight. Press play, or pick a step.
Steps 1, 6 and 7 repeat for every fix. Steps 2 to 5 run each time you upload a new build.
02 Platforms
Flutter builds the Android packages on Windows, Linux and macOS. The iOS release build runs through Xcode, and Xcode runs only on macOS. Pick an operating system to see what it can build.
Sources: Flutter's install guide and iOS release guide. See the list at the end of the page.
03 Flutter shell
This example uses the official webview_flutter plugin. It is a simplified sketch, not html2app's shell source code. It shows the three parts every shell needs: the web files in the app bundle, JavaScript turned on, and one WebView that fills the screen.
dependencies:
flutter:
sdk: flutter
webview_flutter: ^4.14.1
flutter:
assets:
- www/
import 'package:flutter/material.dart';
import 'package:webview_flutter/webview_flutter.dart';
void main() {
runApp(const HtmlShellApp());
}
class HtmlShellApp extends StatelessWidget {
const HtmlShellApp({super.key});
@override
Widget build(BuildContext context) {
return const MaterialApp(
debugShowCheckedModeBanner: false,
home: ShellPage(),
);
}
}
class ShellPage extends StatefulWidget {
const ShellPage({super.key});
@override
State<ShellPage> createState() => _ShellPageState();
}
class _ShellPageState extends State<ShellPage> {
late final WebViewController _controller;
@override
void initState() {
super.initState();
_controller = WebViewController()
..setJavaScriptMode(JavaScriptMode.unrestricted)
..loadFlutterAsset('www/index.html');
}
@override
Widget build(BuildContext context) {
return Scaffold(
body: SafeArea(
child: WebViewWidget(controller: _controller),
),
);
}
}
# Android packages: Windows, Linux or macOS
flutter build apk --release
flutter build appbundle --release
# iOS IPA: macOS with Xcode only
flutter build ipa --release --obfuscate --split-debug-info=build/symbols
04 Build server cost
Set how long a build takes and how often you build. The bars show the monthly cost on each GitHub Actions runner. These are public list prices for hosted runners. The price of the html2app build server is not set yet.
Your builds
Monthly cost by runner
Standard hosted runners are free on public repositories. Private repositories pay per minute after the minutes in their plan. Rates are from GitHub's runner pricing page, checked 20 November 2026.
05 Hardware
Pick the models you would buy. Prices are Apple's US store prices, checked 20 November 2026. The base Mac mini uses its launch price. Other countries and used devices cost differently.
06 App Review
A shell that only shows a website falls under Apple's minimum functionality rule. Use native features through the JS bridge, such as the status bar, fullscreen mode, storage and device information.
Apple expects features, content or UI beyond a repackaged website. Call native features from the web app through the bridge, and test them on a real iPhone.
Apps made with an app generation service are rejected unless the content owner submits them. Submit from your own Apple Developer account.
Link a privacy policy in App Store Connect and inside the app. If users can create an account, offer account deletion inside the app.
If the app offers another social or third-party login for the main account, it must also offer Sign in with Apple, unless an exception applies.
0 of 6 done
Your ticks are not saved. Work through this list before each submission.
Before you submit
07 Status
html2app builds Android apps in the cloud today. We plan to add iOS once the platform has enough traction and revenue to pay for the macOS build infrastructure. There is no release date yet.
Upload a ZIP and download an APK or AAB from html2app. Free debug APKs are available. Signed APK and AAB builds need a paid plan.
Planned, with no release date. This page describes the workflow as we plan it, and it can still change.
08 FAQ
Short answers about the IPA build, the Mac, the iPhone and the costs.