https://github.com/emfcamp/badge-2024-app-store
App Store Infrastructure for Tildagon
https://github.com/emfcamp/badge-2024-app-store
emfcamp
Last synced: 5 months ago
JSON representation
App Store Infrastructure for Tildagon
- Host: GitHub
- URL: https://github.com/emfcamp/badge-2024-app-store
- Owner: emfcamp
- License: mit
- Created: 2024-03-28T17:01:58.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-14T10:12:13.000Z (5 months ago)
- Last Synced: 2026-01-14T14:21:26.492Z (5 months ago)
- Topics: emfcamp
- Language: TypeScript
- Homepage: https://apps.badge.emfcamp.org/
- Size: 551 KB
- Stars: 0
- Watchers: 15
- Forks: 3
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Tildagon App Store
Here's the implementation of the [app store](https://apps.badge.emfcamp.org/) for
[Tildagon](https://tildagon.badge.emfcamp.org/), the EMFcamp 2024 badge.
## Submitting an app
To make an app available in the badge app store, first follow the [app dev
instructions](https://tildagon.badge.emfcamp.org/tildagon-apps/) and put the app in
a repository on GitHub. Currently only GitHub is supported - if you'd like to contribute
support for another platform, see "Hacking the App Store" below
Once your app is in a repository, add the `tildagon-app` topic to your repo.
## Hacking the App Store
The app store is a little typescript monorepo containing two packages:
- _tildagon-app-directory-api_: _a backend that fetches apps from implemented app
sources and exposes them to the web frontend and to the badges_
- _tildagon-app-directory-site_: _a web frontend showing apps and installation
instructions_
You could add additional app sources, modify the website, or add new features.
### Development
The repo is set up as a monorepo with separate packages for the API and the
site.
We use bun to run code as it supports TypeScript natively. To get started,
install the correct version of bun. This is specified in mise.toml. You can
install manually, or with mise.
```bash
mise install
bun install
```
Some packages within the monorepo are libraries that have a build step. To build
those, run:
```bash
bun --filter='*' run build
```
Then you can run the site locally with:
```bash
# First export a GITHUB_TOKEN environment variable with a GitHub personal access token
export GITHUB_TOKEN=your_github_token_here
# Then run the site
bun --filter='*' run dev
```
If you would like to avoid having to provide a GitHub token, for example you
intend to work only on the frontend, you can set the following environment
variable, which will have the backend provide a dataset pulled from the
production app store on 2025-10-07.
```bash
export APP_STORE_MOCK=true
```
#### API
The API is a bun server that uses zod to specify the domain models for the
store, and implements upstream app "registries" - where the app store retrieves
apps from.
#### Site
The site is an Astro site that uses the API to fetch apps and display them.