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

https://github.com/teamreflex/cosmo-web

Objekt & gravity explorer for COSMO
https://github.com/teamreflex/cosmo-web

artms cosmo kpop modhaus nextjs nft objekt react triples web3

Last synced: 5 months ago
JSON representation

Objekt & gravity explorer for COSMO

Awesome Lists containing this project

README

          

# Apollo

A platform for exploring objekts & gravities from [MODHAUS](https://www.mod-haus.com/)' **[Cosmo: the Gate](https://play.google.com/store/apps/details?id=com.modhaus.cosmo)** app via blockchain data.

**Apollo is not affiliated with, endorsed by or supported by MODHAUS or its artists.**

## Features

- View other user's collections via blockchain data
- View an index of every released objekt, number of copies and how it's obtained
- Fuzzy search through objekt collection metadata
- Create shareable objekt wishlists
- Calendar to see when monthly COMO drops are coming
- View objekt transfers
- Per member, season and class collection progress breakdowns
- Collection completion leaderboards
- View historical and live gravity results

## Project

- `apps/web`: Core TanStack Start web app deployed at [apollo.cafe](https://apollo.cafe)
- `apps/indexer`: Subsquid blockchain indexer for cataloging Modhaus objekt collections
- `apps/schedules`: Functions for executing scheduled tasks
- `apps/typesense`: Dockerfile for building Typesense with `curl` available
- `apps/typesense-import`: Sync new objekt collections to the Typesense database
- `packages/cosmo`: COSMO related types and API functions
- `packages/database`: `drizzle-orm` schemas for both databases
- `packages/lint`: Shared oxlint config
- `packages/typescript`: Shared tsconfig.json file
- `packages/util`: Shared utility functions

## Requirements

- [Bun](https://bun.sh/) 1.3.3+
- [Postgres](https://www.postgresql.org/)
- [Redis](https://redis.io/) or [Valkey](https://valkey.io/)
- [Typesense](https://typesense.org/)
- [AWS SES](https://aws.amazon.com/ses/) credentials
- [Discord OAuth](https://discord.com/developers/docs/topics/oauth2) credentials
- [Twitter OAuth](https://docs.x.com/resources/fundamentals/authentication/oauth-2-0/overview) credentials
- [Docker](https://www.docker.com/) (local development)

## Setup

```bash
git clone git@github.com:teamreflex/cosmo-web.git
cd cosmo-web
bun install
cp .env.example .env
turbo i18n
turbo dev --filter web
turbo db:migrate
```

## Tooling

- [Bun](https://bun.sh/)
- [Turborepo](https://turborepo.com/)
- [TanStack Start](https://tanstack.com/start/latest/docs/framework/react/overview)
- [Tailwind v4](https://tailwindcss.com/)
- [shadcn/ui](https://ui.shadcn.com/docs)
- [Drizzle ORM](https://orm.drizzle.team/)
- [Subsquid](https://subsquid.io/)
- [Typesense](https://typesense.org/)

## Contributing

For security reasons, PRs will not be accepted. This project is considered _source available_ for the purpose of scrutiny rather than open source for contributions. If a problem needs reporting, please make an issue or post in Discord.

## Branches

- `main`: Production branch deployed to [apollo.cafe](https://apollo.cafe).
- `polygon`: Last copy of the project compatible with the Ramper-based COSMO API and Polygon blockchain, before Modhaus migrated to privy.io + Abstract on 18/04/2025.
- `abstract-nextjs`: Last copy of the project running on Nextjs, before it was migrated to this current stack on 17/01/2026.

## License

Licensed under the [MIT license](https://github.com/teamreflex/cosmo-web/blob/refactor/abstract/LICENSE.md).

## Contact

- **Discord Server**: [discord.gg/A72VRX8FgK](https://discord.gg/A72VRX8FgK)
- **Email**: kyle at reflex.lol
- **Discord**: kairunz
- **Cosmo ID**: Kairu