{"id":15089863,"url":"https://github.com/henryhale/android-capacitor","last_synced_at":"2026-01-04T12:47:45.547Z","repository":{"id":245892113,"uuid":"819445912","full_name":"henryhale/android-capacitor","owner":"henryhale","description":"⛓️ Build and release your Android app using GitHub Actions","archived":false,"fork":false,"pushed_at":"2025-02-17T14:17:25.000Z","size":31,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-17T14:38:20.269Z","etag":null,"topics":["android","capacitor-android","capacitorjs","css","github","github-actions","henryhale","html","ionic","js","template","web","workflow"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/henryhale.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-24T14:15:41.000Z","updated_at":"2025-02-17T14:17:30.000Z","dependencies_parsed_at":"2024-06-24T17:54:51.187Z","dependency_job_id":null,"html_url":"https://github.com/henryhale/android-capacitor","commit_stats":null,"previous_names":["henryhale/android-capacitor"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henryhale%2Fandroid-capacitor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henryhale%2Fandroid-capacitor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henryhale%2Fandroid-capacitor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henryhale%2Fandroid-capacitor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/henryhale","download_url":"https://codeload.github.com/henryhale/android-capacitor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244825066,"owners_count":20516587,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","capacitor-android","capacitorjs","css","github","github-actions","henryhale","html","ionic","js","template","web","workflow"],"created_at":"2024-09-25T09:02:28.069Z","updated_at":"2026-01-04T12:47:45.521Z","avatar_url":"https://github.com/henryhale.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# android-capacitor\n\n## Overview\nThis template is created to be a starting point for developing mobile\napplications using web technologies.\n\nIt uses [capacitorjs](https://capacitorjs.com) to generate an Android app.\nCurrently, it is simply a development tool that generates apps in **debug mode** (not production-ready app).\n\n## Motivation\nToday, there many web-based development environments like GitHub Codespaces, StackBlitz and more with GitHub intergration.\nAnyone can build \u0026 test websites on the go, whenever they are.\nYou don't have to install anything. But you need a good internet connection.\n\nTo build Android apps, you need to set up quite a number of tools and most importantly of all, a good pc (8GB RAM, 8GB disk space and more).\nTake a look at the recommended computer specifications on this page [here](https://developer.android.com/studio/install).\n\nSo if you are building something awesome but on a resource-constrained device or limited environment (internet cafe or school computer lab), here's a solution. \nLeverage GitHub Actions to build Android apps using [capacitorjs](https://capacitorjs.com). \nDownload the app from GitHub Releases on mobile and enjoy :rocket:\n\n## Usage\n1. First of all, add a build script in your `package.json` file, for example `vite build` while using [vite](https://vitejs.dev). \n\n2. Secondly, edit the [capacitor.config.ts](./capacitor.config.ts) file.\nEdit the config object to suit your project. The `webDir` key takes the folder in which your bundled files are located for example `dist`.\n\n\u003e [!IMPORTANT]\n\u003e \n\u003eIn case you have no build step, add `\"build\": \"echo no build\"` under `scripts` in your `package.json` file. Make `webDir` in [capacitor.config.ts](./capacitor.config.ts) correspond to the folder in which your project files are located for example `src`.\n\n3. Place the app icon in `resources/` folder and name it `icon.png`. It should be at least 1024x1024 in dimensions. For new projects, replace the existing file.\n\n4. Ensure that your have the [.github/workflows/build.yml](.github/workflows/build.yml) file. You can rename it incase of naming collisions. Then do the following;\n\t\n\tAllow the workflow to create a release:\n\t- Go to your repository on GitHub, click on Settings.\n    - In the left sidebar, select Actions \u003e General.\n    - Under Workflow permissions, select Read and write permissions.\n    - Click Save.\n\n5. To generate the app;\n\n   - Create a git new tag for example initial release with tag name `v0.0.1`, run\n\n    ```sh\n    git tag v0.0.1\n    ```\n\n   - Push the tag to GitHub\n \n    ```sh\n    git push origin v0.0.1\n    ```\n\n    This will trigger the workflow and generate your app in the GitHub Releases.\n\n6. Repeat step 5 using a new tag every time you want to re-build the app.\n\n7. Enjoy :rocket:\n\n## Demo\nI developed a counter app to demonstrate the workflow: [source code on github](https://github.com/henryhale/android-capacitor-demo)\n\n## Contributing\nIn case of any issue or bug, please open a new issue [here](https://github.com/henryhale/android-capacitor/issues/new).\n\n## License\n\nReleased under [MIT License](./LICENSE.md)\n\nCopyright \u0026copy; 2024 [Henry Hale](https://github.com/henryhale)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhenryhale%2Fandroid-capacitor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhenryhale%2Fandroid-capacitor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhenryhale%2Fandroid-capacitor/lists"}