This is the official website for DevFest Croatia 2026 (organized by GDG Zagreb), built with Next.js and featuring a modern, responsive design with a multi-year archive.
npm run dev
# or
yarn dev
# or
pnpm devOpen http://localhost:3000 with your browser to see the result.
npm run dev # Start development server
npm run build # Build for production
npm run start # Start production server
npm run lint # Run ESLint
npm run type-check # Run TypeScript type checking
npm run type-check:watch # Run type checking in watch mode├── app/ # Next.js 16 App Router pages
│ ├── page.tsx # Landing page (incl. featured speakers)
│ ├── speakers/ # Speakers listing page
│ ├── _agenda/ # Agenda page, disabled (underscore = not routed)
│ └── archive/ # Past editions: 2023, 2024, 2025 (speakers + agenda)
├── components/ # React components
│ ├── ui/ # shadcn/ui components
│ ├── speakers/ # Speaker tile, detail dialog, placeholder card
│ └── ... # Custom components
├── config/ # Site config (config/site.ts)
├── json/ # Conference data
│ ├── speakers.json # Current year speakers database
│ ├── sessions.json # Current year schedule, served by /api/sessions
│ └── archive/ # Past editions: speakers.json + enter.json/shift.json per year
├── lib/ # Utility functions
└── public/ # Static assets (speaker-photos/<year>/ holds speaker photos)
This project uses a referential data architecture that eliminates duplication between speaker information and stage schedules. See speakers-and-stages.md for detailed documentation.
Key Features:
- ✅ Single source of truth for speaker data
- ✅ Multi-stage support for past editions (Enter & Shift stages)
- ✅ Archive system for historical conferences
- ✅ Type-safe speaker references
- ✅ Easy maintenance and updates
// speakers.json - Central database
{
"speakerName": "Jane Doe",
"name": "Building Modern Web Apps",
// ... complete speaker info
}
// archive/<year>/enter.json - Stage schedule
{
"time": "10:00",
"speakerRef": "Jane Doe", // References speaker by name
"id": 1
}The system automatically merges speaker data with stage schedules at runtime.
Built with modern design patterns:
- shadcn/ui components for consistent design
- Tailwind CSS for responsive styling
- Lucide React icons
- Radix UI primitives (dialog, tabs, accordion)
- Next.js Image optimization
- FeaturedSpeakers: Landing page spotlight cards for up to 3 speakers with
isFeaturedandisPublishable; hidden when there are none, "To be announced" placeholders fill the row on larger screens when there are fewer than 3 - SpeakerTile / SpeakerDetails / SpeakerPlaceholder (
components/speakers/): Speaker card, bio and talk dialog, and placeholder used on/speakersand the landing page - SpeakerCard: Accordion-style speaker profiles used by the archive pages
- ImageGallery / ImageMarquee: Responsive photo gallery and marquee band
- AgendaItem: Agenda display with speaker integration (archive agendas)
Full TypeScript integration with type checking:
npm run type-check:watch # Catch type errors during developmentSupports multiple conference years with backward compatibility:
2023/- Original conference data structure2024/- Referential speaker system2025/- Last archived edition (speakers and both stage schedules)
The current edition (2026) lives in json/speakers.json. Speakers stay hidden until isPublishable is true, and isFeatured adds them to the landing page (max 3). The schedule lives in json/sessions.json and is exposed as a public JSON API (/api/sessions, /api/sessions?type=talk|workshop, /api/sessions/{id}); a session appears there once its speaker is publishable and it has a room and times. See speakers-and-stages.md.
- Mobile-first approach
- Multi-breakpoint layouts
- Dark mode support via next-themes
- Next.js 16 - React framework with App Router
- React 19
- TypeScript - Type safety and developer experience
- Tailwind CSS 4 - Utility-first styling (configured in CSS,
app/globals.css) - shadcn/ui - Modern component library
- Radix UI - Accessible component primitives
postcss.config.js- PostCSS / Tailwind CSS 4 setuptsconfig.json- TypeScript configurationnext.config.js- Next.js configurationCLAUDE.md- Claude Code development guidelines
speakers-and-stages.md- Detailed explanation of the speaker/stage data architectureCLAUDE.md- Development guidelines for Claude Code instances
The easiest way to deploy is using the Vercel Platform:
- Connect your repository to Vercel
- Configure build settings (auto-detected)
- Deploy with zero configuration
npm run build # Creates optimized production build
npm run start # Serves production build locally- Follow the TypeScript patterns established in the codebase
- Use the referential data architecture for speaker management
- Run type checking before committing:
npm run type-check - Follow the component patterns in
components/directory - Update documentation when making architectural changes
For questions about DevFest Croatia 2026, contact: zagrebgdg@gmail.com
GDG Zagreb - Organizing DevFest Croatia 2026 🎉