Run the MVP locally
copy .env.example .envnpm run db:migratenpm run db:seednpm run dev:webStart Postgres and Redis first. Docker validation is pending on the Ubuntu host because Docker is not installed on this Windows machine.
What already works
- Multi-tenant schema with organizations, sources, events, jobs, digests, and alerts
- GitHub source registration and verified webhook ingestion
- Background job queue wiring for event processing
Source setup
Create a workspace from the UI
GitHub and Discord are both live. Connect the same repo or server the HamCult integrations can access, then trigger a real issue, comment, or Discord message to verify the pipeline.
Register a repository
Create a workspace and bind it to a GitHub repo for webhook ingestion.
Before you submit this form
- Install the GitHub App on the repo you want to monitor.
- Set the webhook URL to
https://hamcult.com/api/github/webhook. - Use the same repo here, then create an issue or comment to verify ingestion.
Register a guild
Create a workspace for Discord ingestion and define the channels you care about.
How to find these values
- In Discord, open
User Settings > Advancedand turn onDeveloper Mode. - Right-click the server name and choose
Copy Server IDfor the Guild ID. - Guild name is just the visible server name. You can leave it blank and HamCult will use your workspace name.
- For channels, right-click a channel and choose
Copy Channel ID, or just type channel names likesupport.
Workspaces