Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zenoxs/tauri-appcenter-companion
A companion app written with React and Tauri to help manage your applications on AppCenter.
https://github.com/zenoxs/tauri-appcenter-companion
appcenter companion-app cross-platform dashboard react rust tauri typescript
Last synced: 3 months ago
JSON representation
A companion app written with React and Tauri to help manage your applications on AppCenter.
- Host: GitHub
- URL: https://github.com/zenoxs/tauri-appcenter-companion
- Owner: zenoxs
- License: gpl-3.0
- Created: 2022-05-11T12:47:37.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-07-21T07:12:53.000Z (over 2 years ago)
- Last Synced: 2024-04-27T14:33:54.680Z (7 months ago)
- Topics: appcenter, companion-app, cross-platform, dashboard, react, rust, tauri, typescript
- Language: TypeScript
- Homepage:
- Size: 2.6 MB
- Stars: 16
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-tauri - AppCenter Companion - Regroup, build and track your `VS App Center` apps. (Applications / Developer tools)
README
# Tauri AppCenter Companion
[![publish](https://github.com/zenoxs/tauri-appcenter-companion/actions/workflows/publish.yml/badge.svg)](https://github.com/zenoxs/tauri-appcenter-companion/actions/workflows/publish.yml)
[![GitHub license](https://badgen.net/github/release/zenoxs/tauri-appcenter-companion)](https://github.com/zenoxs/tauri-appcenter-companion/releases/latest)
[![GitHub license](https://badgen.net/badge/os/windows%20%7C%20macOS%20%7C%20linux/black)](https://github.com/zenoxs/tauri-appcenter-companion/releases/latest)
[![GitHub license](https://badgen.net/badge/license/GPL-3.0/blue)](https://github.com/zenoxs/tauri-appcenter-companion/blob/main/LICENSE)
A companion app written with **React** and **Tauri** to help you manage your apps on appcenter. The idea is to provide a simple way to group apps from your appcenter into one view, this way you can easily build all your related apps with just one click and track progress and status.
![Main App Light](./screenshots/main_light.png)
![Main App Dark](./screenshots/main_dark.png)## Features
- [x] View the (live) build status of all your apps
- [x] Start/Cancel your app build
- [x] Start/Cancel all your apps packaged in a bundled apps
- [x] The application can work with restricted access tokens (scoped on one app and with full access / read only)
- [x] Light/dark theme
- [ ] View the logs of your builds
- [ ] View all the available builds
- [x] Edit / remove a bundled app## How to use it ?
### Add token api
First install the application from the [release page](https://github.com/zenoxs/tauri-appcenter-companion/releases/latest):
- **AC.Companion_x.x.x_x64.dmg** for intel MacOS
- **AC.Companion_x.x.x_x64_en-US.msi** for Windows
- **ac-companion_x.x.x_amd64.AppImage** for Linux
- **ac-companion_x.x.x_amd64.deb** for Debian\* systemThen you will need to create an API Token from your AppCenter account. This can be done in 2 ways:
- From your Appcenter [account settings](https://appcenter.ms/settings/apitokens), **/!\\ remark** if you do so generated token will have access to all your apps.
- From the settings of your app : https://appcenter.ms/orgs/{owner}/apps/{app-name}/settings/apitokens![Create appcenter api token](./screenshots/create-appcenter-api-token.png)
Then copy the generated token, open the "API Tokens" settings from the app and add a new token.
### Create a bundled app
_What is a bundled app ?_
A bundled app is a logical representation of multiple appcenter's apps. If you relate on a single base code framework and you want to build, for example, your Android and iOS application you must go to application detail each time to start and follow the build. With a bundled app you can manage all your apps build in a single view.**To create a bundled app** you need to navigate to the **Applications** page and click on the **Add** button. Then the app will fetch all your registered token-based apps with their configured branches. You can select which branches will compose your bundled application and the name of your bundled application. Then press the **Save** button to create your bundled application and voilà.
## Confidentiality & Security
**Q:** Do AC Companion can acccess to my appcenter's account?
**A:** No, the application is designed to be a serverless application. All your data is stored in your local machine. AC Companion only uses the [App Center API](https://openapi.appcenter.ms/) to communicate with your appcenter's account.
---
## Development
### Install dependencies
```shell
yarn install
```### Start app in dev
```shell
yarn run tauri dev
```### Build the app
```shell
yarn run tauri build
```