Guild Center is an open-source application within the Astron ecosystem. It serves as a public, modular, and real-time guild directory — similar to Disboard or Top.gg — fully integrated with Astron bots. Server owners can create a public profile, receive votes and bumps, and link their guilds into collective hubs.
- 🔎 Advanced search and filtering of listed public guilds
- 📢 Public profile pages for each server, with stats, tags, and banners
- 🗳️ Voting and bumping system with anti-spam handling
- 🧑🤝🧑 Guild hubs to group multiple servers under a shared identity
- 🔗 Direct integration with Astron bots to automate bumps and track stats
- 🛡️ Optional moderation of listed profiles (handled by Sky Genesis Enterprise)
- 🧠 Seamless integration with Astron Dashboard, unlocking more features
| Layer | Stack |
|---|---|
| Backend API | Node.js (Express) via https://api.astron-collection.com |
| Database | PostgreSQL (hosted on o2switch) |
| Discord Bot | Discord.js (v14+) |
| Authentication | Discord OAuth2 (user login + guild ownership check) |
- Node.js v18+
- PostgreSQL
- A Discord bot with scopes:
bot,applications.commands,identify,guilds
git clone https://github.com/Sky-Genesis-Enteprise/astron-guild.git
cd guild-centerCopy the example env file:
cp .env.example .envFill in your own values:
DISCORD_CLIENT_ID=...
DISCORD_CLIENT_SECRET=...
DISCORD_BOT_TOKEN=...
API_BASE_URL=https://api.astron-collection.com
POSTGRES_URL=postgresql://user:pass@localhost:5432/guildcentercd frontend
npm install
npm run devcd api
npm install
npm run dev- Log in via Discord on Guild Center
- Select one of your guilds and make it public
- Customize its profile (description, tags, banner, etc.)
- Invite the Astron bot to your guild to enable bumping and voting
- Share your guild or hub page with your community!
GET /guilds/public– List all public guilds with filtersGET /guild/:id– Get full details of a guildPOST /guild/:id/bump– Bump the guild (rate-limited)POST /guild/:id/vote– Vote for a guild (OAuth2)PATCH /guild/:id– Update guild info (owner only)
- Only guild owners or admins (via RBAC) can manage public listings
- Anti-spam throttling for voting and bumping
- All user actions are tied to their Discord account via OAuth2
We welcome community contributions! Please read contributing.md before submitting a pull request.
# Fork, then create a feature branch:
git checkout -b feature/your-feature-nameDeveloped and maintained by Sky Genesis Enterprise as part of the Astron suite.
Contact: support@skygenesisenterprise.com
This project is released under the AGPLv3 licence.
See LICENSE for details.