Skip to content
Get packs

Guide · Open source

How to use PakePlus-iOS: wrap a web app for mobile

Updated · written with AI from the project's own documentation and checked against our catalogue data

PakePlus-iOS is the iOS edition of the PakePlus project, which packages a webpage or a built web project such as HTML, Vue or React into a native-style app kept under 5 MB. This guide is for people with an existing site or compiled front-end who want an app wrapper without heavy local tooling. By the end you will know what you need before starting, how the GitHub token workflow works, and where the README leaves details unclear.

PakePlusSjj1024/PakePlus-iOS · ★ 10.1k · MIT

Quick start

  1. 1Confirm your project fits. Make sure you have a website or a compiled Vue/React dist folder or index.html to wrap.
  2. 2Clone the repository. Run git clone https://github.com/Sjj1024/PakePlus-iOS to get the source.
  3. 3Create a GitHub token. Generate a token with the permissions listed for your token version in the README guide.
  4. 4Set up a project. Add the token in PakePlus, create a new project and configure it.
  5. 5Preview the app. Open the preview in a new window to check that your content loads as expected.
  6. 6Publish and download. Click publish to package the app through GitHub Actions, then download it from the release page.

Check whether PakePlus-iOS fits your project

PakePlus-iOS suits people who already have a website, and Vue or React developers who have a compiled dist folder or an index.html file. The project mainly wraps web content, so it is not a fit if you need deep native iOS features.

The README does not describe App Store distribution, so a signed, App Store-ready release is not something it promises. Treat any iOS build steps as unverified until you confirm them yourself.

  • Good fit: wrapping an existing website or static web build
  • Good fit: avoiding complex local build dependencies
  • Poor fit: App Store submission without further setup
  • Poor fit: apps that need deep native iOS functionality

Get the source and prepare a GitHub token

The README's install instruction is to clone the repository. You need a GitHub account and a token. The README says the process is driven by a GitHub token and GitHub Actions rather than local build tools.

The README links to a token guide in English, Simplified Chinese and Japanese. Token permissions differ between the beta and classic versions, so follow the guide for the version you use.

  • A GitHub account with access to the repositories you need
  • A GitHub token with the permissions listed in the README
git clone https://github.com/Sjj1024/PakePlus-iOS

Understand the token permissions

The README lists permissions for two token types. For the beta version it lists repository access, Actions, Administration, Contents, and Issues. For the classic version it lists repo and workflow.

The README says your token is stored only locally and your project stays in your own Git repo. Grant only the permissions listed for the version you are using.

  • Beta: All repositories, Actions, Administration, Contents, Issues
  • Classic: repo and workflow

Create a project and package it

After adding the token, set up a new project and its configuration. The README says PakePlus forks a PakePlus repository into your account; the README excerpt is cut off at that point, so check the in-app prompts for the rest.

You can preview the app in a new window, then click the publish button to package it. The README says packaging runs in the cloud through GitHub Actions, so you do not need local build dependencies.

  • Add your GitHub token
  • Create a new project and configure it
  • Preview the app in a new window
  • Click publish to package the app
  • Download the result from the release page

Fix the Mac 'App is damaged' warning

The README says Mac users may see an 'App is damaged' warning on installation. It explains that the application lacks an official signature, which the author says costs $99 per year, so the author suggests bypassing the check manually.

Only run this command on an app you trust. Replace the app name with your own when it applies to a packaged app.

sudo xattr -r -d com.apple.quarantine /Applications/PakePlus.app

Troubleshoot issues and report bugs

The README advises downloading the latest version if something fails. It notes that versions before 2025 were based on Tauri v1.0 and that Tauri was upgraded to v2.0 in 2025.

If the latest version still fails, the README asks you to submit an issue with detailed information so the maintainers can resolve it faster. Debug mode is available for finding bugs during preview or release.

  • Update to the latest release first
  • Submit an issue with detailed steps if the problem persists
  • Use debug mode to find bugs during preview

What people use it for

  • Wrap an existing marketing website into a mobile-style app
  • Package a Vue or React project that has a compiled dist folder, without buying a server
  • Hide ads on a website with custom injected JavaScript, as the README describes
  • Give internal company staff access to a site only through a dedicated client
  • Use a lighter alternative to Tauri2 when the environment is too heavy

Frequently asked questions

Is PakePlus-iOS free?

The project is released under the MIT licence, which the README describes as an open source licence. The README does not state a price for the project itself, and it mentions a $99 per year cost only for an official Mac signature.

What do I need before I start PakePlus-iOS?

You need a GitHub account and a GitHub token with the permissions listed in the README for your token version. The README says you do not need complex local dependencies.

How do I install PakePlus-iOS?

The README's install instruction is to clone the repository with git clone https://github.com/Sjj1024/PakePlus-iOS. The README does not clearly explain how the iOS version is installed or built, so verify those steps yourself.

Can PakePlus-iOS make an App Store-ready iOS app?

The README does not describe App Store distribution, so it does not claim to produce a signed, App Store-ready release. Plan extra setup for signing and submission.

Why does my Mac show an 'App is damaged' warning?

The README says the app lacks an official signature, so macOS may block it after installation. It gives a sudo xattr command to remove the quarantine attribute, which you should only run on software you trust.

How does PakePlus-iOS compare to Tauri or Electron?

The README says PakePlus is smaller than Electron and that it uses native frameworks for Android and iOS that it describes as smaller and faster than Tauri2. Those are the project's own claims, so test the size and speed on your own app.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

PakePlus-iOS is worth trying if you have a web project and want a small wrapper without installing local build tools, and you are comfortable with GitHub tokens. Pick something else if you need App Store-ready signing, deep native iOS features, or you are not comfortable managing repository permissions.

Install options & downloads