An open API service indexing awesome lists of open source software.

https://github.com/mcs-cli/registry

MCS Tech Pack Registry
https://github.com/mcs-cli/registry

Last synced: 2 months ago
JSON representation

MCS Tech Pack Registry

Awesome Lists containing this project

README

          

# MCS Tech Pack Registry

The public registry for [MCS](https://mcs-cli.dev) tech packs. Browse, search, and submit packs at [techpacks.mcs-cli.dev](https://techpacks.mcs-cli.dev).

## Architecture

- **Frontend**: Static HTML/CSS/JS served by Cloudflare Pages
- **API**: Cloudflare Workers (edge functions)
- **Data**: Cloudflare KV (key-value store)
- **Bot prevention**: Cloudflare Turnstile
- **Reindexing**: Cron Trigger every 6 hours via GitHub GraphQL API

## API Endpoints

| Method | Path | Description |
|--------|------|-------------|
| `GET` | `/api/packs` | List/search packs (`?q=`, `?sort=stars\|recent`, `?limit=`, `?offset=`) |
| `GET` | `/api/packs/:identifier` | Get a single pack |
| `POST` | `/api/submit` | Submit a new pack |
| `POST` | `/api/reindex` | Trigger manual reindex |

## Local Development

```bash
npm install
cp .dev.vars.example .dev.vars # Edit with your tokens
npm run dev
```

## Deploy

```bash
npm run deploy
```

## Submit a Pack

Any public GitHub repository with a valid `techpack.yaml` at the root can be submitted. No account required — just paste the URL.

## License

MIT