Moim is a federated events & places service. In Korean, it is written as '모임', pronounced /mo-im/, like "mo-eem". It means "gathering" or "meetup".
Built on TanStack Start, Drizzle, and ActivityPub.
pnpm install cp .env.example .env docker compose up -d pnpm db:migrate pnpm dev- Events -- create, publish, RSVP, attendee tracking, event dashboards, ICS calendar feeds
- Groups -- federated Group actors, member management, group posts, RSS feeds
- Places -- location management, H3 geo indexing, check-ins, nearby search, map snapshots
- Polls -- group polls with federated Question/Vote support
- Discussions (CRM) -- attendee inquiries and organizer replies on events
- Authentication -- Fediverse OTP, Misskey MiAuth, Mastodon OAuth, linked accounts
- Admin panel -- user/group/event/place/banner/category management
- ActivityPub federation -- actors, inbox/outbox, WebFinger, NodeInfo, content negotiation
- WebFinger:
/.well-known/webfinger - NodeInfo:
/.well-known/nodeinfo→/nodeinfo/2.1 - Actor:
/ap/actors/{identifier}(content-negotiated) - Inbox:
/ap/actors/{identifier}/inbox - Shared inbox:
/ap/inbox - Outbox:
/ap/actors/{identifier}/outbox - Notes:
/ap/notes/{noteId} - Questions:
/ap/questions/{questionId} - Places:
/ap/places/{placeId} - Human profiles:
/groups/@{identifier},/users/@{identifier}
POST /api/auth/otp-requestswith{ "handle": "alice@example.com" }- Post the OTP on your Fediverse account.
POST /api/auth/otp-verificationswith{ "handle": "alice@example.com" }
POST /api/auth/misskey/miauth-startwith the Misskey instance domain.- User authorizes on Misskey. Callback:
/auth/misskey/miauth-callback
POST /api/auth/mastodon/oauth-startwith the Mastodon instance domain.- User authorizes on Mastodon. Callback:
/auth/mastodon/oauth-callback
All business endpoints live under /api. ActivityPub and federation endpoints remain outside /api under /.well-known/*, /nodeinfo/*, and /ap/*.
| Domain | Examples |
|---|---|
| Auth | POST /api/auth/otp-requests, GET /api/session, DELETE /api/session |
| Users | GET /api/users?query=…, GET /api/users/settings |
| Groups | POST /api/groups, GET /api/groups/by-handle/:handle, PATCH /api/groups/:groupId |
| Events | GET /api/events, POST /api/events, PUT /api/events/:eventId/rsvp, POST /api/events/:eventId/publish |
| Discussions | GET /api/events/:eventId/discussions, POST /api/events/:eventId/discussions/:inquiryId/replies |
| Polls | POST /api/groups/:groupActorId/polls, POST /api/polls/:pollId/vote |
| Places | GET /api/places, GET /api/places/nearby, POST /api/check-ins |
| Admin | GET /api/admin/users, GET /api/admin/banners, POST /api/admin/place-categories |
| Feeds | GET /groups/@{handle}/feed.xml (RSS), GET /groups/@{handle}/events.ics (ICS) |
Copy .env.example and review the variables. Key groups:
- Database:
DATABASE_URL,MIGRATION_DATABASE_URL - Federation:
FEDERATION_DOMAIN,FEDERATION_HANDLE_DOMAIN,FEDERATION_PROTOCOL - S3 storage:
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY,S3_BUCKET,S3_ENDPOINT - Admin:
INSTANCE_ADMIN_HANDLES
See .env.example for the full list with defaults.