Hackathon Starter Kit · Odoo 19 + Next.js 15
A clear, portfolio-ready tech stack for Hackathon Platform
Each technology includes what it is, why it matters for this multi-tenant product and the value it delivers. The goal is to showcase a production-ready stack for organizers, investors and future teammates.
Highlights
Key strengths of the platform
Three high-level pillars before diving into the detailed categories.
Production-ready multi-tenant architecture
One VPS serves multiple hackathons thanks to company_id filtering, wildcard subdomains and optional custom domains.
- Tenant resolution based on Host header + native record rules.
- Events, teams, submissions and sponsors are automatically isolated.
- Documented in `02-ARQUITECTURA-MODELO.md` and `03-API-DEVOPS.md`.
Secure API with JWT and social login
Custom controllers expose semantic HTTP responses, refresh tokens and OAuth bridges.
- Auth controller validates hashes and emits short-lived + refresh tokens.
- NextAuth swaps Google/GitHub tokens for platform JWTs via `/auth/social-login`.
- Redis stores blacklists and rate-limiting metadata.
Operations you can run anywhere
Docker Compose, health scripts, GitHub Actions and Nginx TLS make deployments repeatable.
- Compose files include health checks for every service.
- Certbot + Nginx provide wildcard and custom-domain certificates.
- `scripts/health-check.sh` verifies containers, endpoints and system resources.
Full stack
Technologies by category
Tabs with individual cards describing each tool (version, description, how it is used in Hackathon Platform).
Next.js 15 with React 19 powers the entire public experience, from marketing pages to dynamic event hubs.
Next.js
React framework with Server Components, dynamic routing, ISR and SSR built in.
How it is used in the platform
Renders landing pages, event timelines, sponsor grids and rankings while fetching data directly from the Odoo API in Server Components.
React
Component-based UI library with hooks for state, effects and context.
How it is used in the platform
Widgets such as Navbar, PublicVoting and MeetingRoomCard rely on React hooks and Context to keep authentication and collaboration states in sync.
TypeScript
Static typing with powerful inference and shared interfaces.
How it is used in the platform
`lib/types/event.ts` defines Events, Teams, Projects and Voting contracts so `odooApi` and every Server Component consume a single source of truth.
Tailwind CSS
Utility-first styling with custom palettes, animations and glassmorphism blocks.
How it is used in the platform
Hero gradients, responsive grids and cards reuse tokens defined in `globals.css` and `tailwind.config.ts`, matching the Hackathon Platform branding.
NextAuth
Authentication toolkit for OAuth providers, custom credentials and JWT sessions.
How it is used in the platform
Google/GitHub logins exchange provider tokens for platform JWTs via `/api/v1/auth/social-login`, storing access/refresh tokens in HttpOnly cookies.
Radix UI + shadcn
Accessible primitives (Card, Button, Dialog, Progress) styled with Tailwind.
How it is used in the platform
Every card, form and CTA on this tech page reuses the same `components/ui` set, guaranteeing visual consistency across Hackathon Platform screens.
Skills demonstrated
What this project proves
A concise list for conversations with organizers, partners or evaluators.
- Server Components + typed data fetching with Next.js App Router
- Reusable React component system with shadcn/Radix primitives
- Integration with JSON-2 and bespoke Odoo controllers
- Consistent branding, i18n hooks and responsive layouts
- Multi-service containerization with Docker and Compose 3.8
- Automated TLS, reverse proxy configuration and rate limiting
- Health monitoring via scripts + Compose health checks
- CI/CD workflows documented per milestone
- Complete data model for events, scoring, voting and consents
- Seed data + demo environments reproducible in minutes
- Redis-powered queues for translations and meeting-room auditing
- Playbooks/ADRs that capture every architectural decision
- Live documentation (15+ playbooks) for onboarding and ops
- Roadmaps/checklists aligning M0 → M5 deliveries
- Support processes with health scripts and debugging utilities
- Clear communication of scope, risks and success metrics
View Source
Open code ready for review
Transparency matters: both the frontend and Odoo backend are public for auditing or collaboration.