# BattleTabs Community

> The official community site for BattleTabs, a free-to-play naval combat game by Gangbusters Ltd. Captains submit cosmetic items (skins, ships, decorations), vote on each other's work, read patch notes, and browse the player-maintained wiki.

This site (battletabs.com) is the BattleTabs hub — community submissions, blog, wiki, fleet, Battle Club. The game itself lives at battletabs.io.

## Key sections

- [Home](https://battletabs.com/): marketing + portal hub linking to Play, Blog, Community, Wiki
- [Community](https://battletabs.com/community): captain-submitted cosmetic content (skins, ships, decorations). Vote, filter by category (background/clothing/extra/hair/hat/head/other), sort by newest/popular/oldest.
- [Community Category Guide](https://battletabs.com/community/guide): visual reference showing what each cosmetic category looks like in-game.
- [Blog](https://battletabs.com/blog): patch notes, season announcements, dev diaries, community spotlights. Also available as RSS at `/blog/rss.xml`.
- [Wiki](https://battletabs.com/wiki): player-maintained reference for ships, abilities, tactics, terminology.
- [Battle Club](https://battletabs.com/club): paid subscription tier — premium themes, palettes, perks.

## Authentication & participation

- Sign in is Discord OAuth only. There is no email/password.
- To submit cosmetic items or vote, a captain must be a member of the BattleTabs Discord server (https://discord.gg/kvJKXsu).
- Discord roles map to site roles: Admin → site admin (full control), Community Mod → site moderator (review submissions). Other Discord roles are displayed on the user's profile but don't grant site permissions.

## Submission lifecycle

A cosmetic submission goes: `in_review` → `approved` (visible in Community) | `changes_requested` (back to user) | `rejected` | `flagged`. Only approved submissions appear in public listings. Featured submissions get a badge. In-game submissions are ones the dev team has actually shipped.

## Where to find things

- Per-submission URL: `/community/item/<id>`
- Per-user profile: `/user/<userId>`
- Per-blog-post: `/blog/<slug>`
- Per-wiki-page: `/wiki/<slug>`

## Sitemap & feeds

- [XML sitemap](https://battletabs.com/sitemap.xml) — all canonical URLs
- [Blog RSS feed](https://battletabs.com/blog/rss.xml) — for feed readers
- [Submissions JSON Feed](https://battletabs.com/community/submissions.json) — machine-readable feed of approved community submissions (JSON Feed v1.1, with `_battletabs` namespaced extension for category/voteCount/license)

## Tech stack (for agents working on the codebase)

- Frontend: React + Vite + Tailwind, TypeScript
- Backend: Convex (queries/mutations/actions in `convex/*.ts`)
- Hosting: Netlify (frontend) + Convex Cloud (backend)
- Auth: custom Discord OAuth (not Convex Auth)
- Source: https://github.com/Gangbusters-io/battletabs_modding_site_convex

## Other resources

- [Privacy Policy](https://battletabs.com/privacy)
- [Terms of Service](https://battletabs.com/terms)
- Play the game: https://battletabs.io
- Discord: https://battletabs.com/discord

## License

- Wiki content (`/wiki/*`) is licensed **CC BY-SA 4.0**. Much of it is imported from or shared with the community wiki; you may reuse it with attribution under the same license.
- Blog and community content (`/blog/*`, `/community/*`, and this site's original copy) is **© Gangbusters Ltd**. It may be cited with attribution — please link back to the source page on battletabs.com.