cognivo-future-technologies-cft/awardx

AwardX is an open-source web application for running awards competitions, grants, and recognition programs. Organizations can create programs, collect entries through customizable forms, manage judging rounds, enable public voting, and announce winners from a single dashboard. The platform is designed to be self-hosted: you clone the code, connect it to your own Supabase database, and run it on your own infrastructure. The main pieces of the system cover the full lifecycle of an awards program. A drag-and-drop form builder handles entry collection, and entries can be organized into nested categories. Judging is managed through configurable rounds with panel and group assignments, and judges can be scoped to specific categories. Public voting rounds with leaderboards are also supported. For paid submissions, the platform integrates with Stripe, Razorpay, and PayPal. Email notifications for invites and announcements go through Resend. On the technical side, the frontend is built with React 19 and TypeScript, using Vite as the build tool. The backend has two parts: an Express server that handles privileged operations like round advancement and judge assignments, and serverless route handlers for Vercel. The database is PostgreSQL hosted through Supabase, with row-level security policies enforcing access at the database level. Authentication is handled by Supabase Auth, supporting email/password and OAuth providers like Google and GitHub. Setting it up requires Node.js 20 or later and a Supabase project. You clone the repository, copy a provided environment variable template, run database migrations, and start the development server. The project includes unit tests via Vitest and end-to-end tests via Playwright. It is licensed under AGPL-3.0, which requires that modifications also be open-sourced if distributed.