Braga AI Builders

This is the Braga-specific downstream deployment of Local Community Platform, an open-source platform for local and interest-based communities. The live community is at braga-ai-builders.vercel.app.

Braga can develop community-specific features here without automatically adding them to the canonical platform. Reusable features should be generalized and proposed upstream; upstream releases reach Braga only through reviewed sync pull requests. See Upstream and Braga downstream.

Braga AI Builders is for people actively using AI—from everyday ChatGPT users to advanced builders and everyone in between.

What it includes

• Passwordless existing-member sign-in plus private member- and admin-shared invitation URLs
• A rolling pool of five single-use links per active member, replenished after each confirmed new member
• Admin campaign links with configurable capacities from 1 to 50
• Required transactional-email consent with an explicit no-marketing promise
• Public posts, anonymous posting and upvoting, categories, and tags
• Optional public member profiles with author hover cards
• Public events that send RSVP traffic to an external event page
• Organizer tools for invites, events, post moderation, and a private member database
• Super-admin controls for assigning admins, suspending access, and deleting members
• Public bug reporting with optional contact details, organizer triage, and optional email notifications
• Private-by-default profiles, Row Level Security, restricted RPCs, and Edge Functions
• Astro, React, Tailwind, Supabase, Bun, and Vercel

Use it for your community

1. Fork this repository or click Use this template on GitHub.
2. Edit src/config/community.ts with your community identity, landing-page language, chat link, and repository URL.
3. Create your own Supabase project and apply the migrations.
4. Configure and deploy the three Edge Functions.
5. Deploy the frontend to your own Vercel project.

Every installation must use its own Supabase and Vercel projects. Forks never connect to Braga's production data.

See Self-hosting for the full setup, including the one-time bootstrap invite and organizer account.

Optional bug-report email

Bug reports are always stored in Supabase and available to organizers at /admin/bug-reports. Email alerts are optional and use Resend through a database trigger; the platform does not contain or inherit Braga's credentials.

A fork can use a free Resend account without configuring a domain by sending from Local Community Platform <onboarding@resend.dev> to the email address attached to that same Resend account. Resend treats this as testing mode and blocks other recipients until the installation verifies its own domain. See the self-hosting notification setup for Vault configuration, current free-plan limits, and the verified-domain path.

Local development

bun install
cp .env.example .env
bun run dev

Auth and data features require a local or disposable Supabase project. See Local development.

Configuration

Public community identity lives in one tracked file:

// src/config/community.ts
export const communityConfig = {
  name: 'Your Community',
  city: 'Your City',
  tagline: 'A local community for shared interests',
  description: 'A short description of your community.',
  whatsappUrl: 'https://chat.whatsapp.com/...',
  githubUrl: 'https://github.com/you/local-community-platform',
  home: {
    eyebrow: 'A local community in Your City',
    heroTitle: 'Come meet your people.',
    heroBody: 'Explain who the community is for and what connects its members.',
    experienceRange: ['Member perspective one', 'Member perspective two'],
    experienceFooter: 'A short invitation to participate.',
    closingStatement: 'A final statement about what members share.'
  }
};

Browser-safe Supabase settings belong in .env; Edge Function secrets and notification credentials belong in Supabase's secret stores. Never commit service-role keys, database passwords, deployment tokens, provider API keys, or production .env files.

Commands

bun run dev      # local development server
bun run check    # Astro and TypeScript diagnostics
bun test         # contract and security tests
bun run build    # diagnostics plus production build
bun run verify   # complete verification gate

Documentation

• Braga downstream operations
• Self-hosting
• Upstream and Braga downstream
• Local development
• Deployment
• Contributing
• Security policy
• Changelog

License

MIT. You may use, modify, host, and redistribute the platform, including for commercial purposes, subject to the license notice.