A comprehensive event management system built with React, TypeScript, and shadcn/ui. Designed for managing conferences, summits, and academic events with features for abstract submissions, attendee registration, ticketing, and communication.
- Multi-conference abstract submission system with dual-role support (Submitter/Reviewer)
- Complete review workflow with status tracking (Draft, Submitted, Accepted, Rejected)
- Detailed reviewer feedback and decision management with rating breakdowns
- User-friendly portal with sidebar navigation and breadcrumb trails
- Submission deadlines with countdown tracking
- File attachment support for research papers and supplementary materials
- Comprehensive attendee registration and tracking
- Check-in system with QR code support
- Advanced filtering and search capabilities
- Bulk import functionality
- Attendee analytics and reporting
- Custom field support for diverse event types
- Multi-tier ticket management with real-time availability
- Coupon and discount system with flexible rules
- Ticket portal for attendees with purchase history
- Payment integration ready
- Early bird and group discount support
- Visual email template builder with drag-and-drop interface
- Maily.to integration for professional templates
- Pre-built templates (Welcome, Conference Updates, Reminders)
- Email sending and delivery tracking
- Template management and versioning
- Hotel and accommodation booking integration
- Room allocation and management
- Special requirements tracking
- Accommodation analytics and reporting
- Custom badge designer with drag-and-drop elements
- QR code generation for check-ins
- Template management for different attendee types
- Bulk printing support
- Frontend: React 18 + TypeScript
- Build Tool: Vite 5
- UI Framework: shadcn/ui (Radix UI primitives + Tailwind CSS)
- Styling: Tailwind CSS with custom design system
- Routing: React Router v6
- Forms: React Hook Form + Zod validation
- State Management: TanStack Query (React Query)
- Email: Maily.to integration
- Icons: Lucide React + Tabler Icons
- Maps: MapLibre GL + Deck.gl
- Charts: Recharts
- Animations: Framer Motion
# Clone the repository
git clone <repository-url>
# Navigate to project directory
cd <project-name>
# Install dependencies
npm install
# Start development server
npm run dev# Development server (default port: 8080)
npm run dev
# Build for production
npm run build
# Preview production build
npm run preview
# Run linting
npm run lintThe application will be available at http://localhost:8080
The abstract portal includes test credentials for easy development:
Submitter Account:
- Email:
user@example.com - Password:
user123
Reviewer Account:
- Email:
reviewer@example.com - Password:
reviewer123
Access the portal at: /abstracts/portal
Comprehensive project documentation is available in the /docs folder with 107+ documents organized for developers, AI agents, and LLMs:
- Documentation Index - Complete overview of all documentation
- Quick Reference - Fast access to common tasks
- Structure Guide - Visual documentation structure
- Changelog - Project history and updates
- Features (
/docs/features) - 64 feature-specific guides organized by module - Guides (
/docs/guides) - Step-by-step tutorials and workflows - UI Components (
/docs/ui-components) - Component documentation and usage - Implementations (
/docs/implementations) - Technical implementation details - Troubleshooting (
/docs/troubleshooting) - Problem-solving guides - Summaries (
/docs/summaries) - High-level overviews - Templates (
/docs/templates) - Reusable documentation templates
src/
├── components/ # Reusable UI components
│ ├── abstracts/ # Abstract submission components
│ ├── attendees/ # Attendee management components
│ ├── badge-printing/ # Badge design components
│ ├── email/ # Email builder components
│ └── ui/ # shadcn/ui components
├── pages/ # Route pages
│ ├── abstracts/ # Abstract management pages
│ ├── attendees/ # Attendee pages
│ ├── registration/ # Registration & ticketing
│ └── email/ # Email management
├── utils/ # Utility functions and helpers
├── types/ # TypeScript type definitions
└── lib/ # Third-party library configurations
- Manage multiple conferences and events simultaneously
- Track abstract submissions with detailed review workflows
- Handle attendee registration and real-time check-ins
- Create and send professional branded emails
- Generate comprehensive reports and analytics
- Design custom badges with QR codes
- Submit research abstracts with file attachments
- Track submission status with detailed feedback
- Register for events and purchase tickets
- Book accommodation through integrated system
- Receive automated event updates
- Access submission history and documents
- Review assigned abstracts with structured feedback forms
- Provide detailed ratings across multiple criteria
- Track review assignments and deadlines
- Submit decisions with comprehensive feedback
- View submission history and statistics
The project uses environment variables for configuration. Create a .env file in the root:
# API Configuration
VITE_API_URL=your_api_url
# Email Service
VITE_EMAIL_API_KEY=your_email_api_key
# Other configurations as neededFully responsive design optimized for all devices:
- Desktop: 1920px+ (Full feature set)
- Laptop: 1024px - 1919px (Optimized layouts)
- Tablet: 768px - 1023px (Touch-friendly)
- Mobile: 320px - 767px (Mobile-first approach)
# Run development server
npm run dev
# Build for production
npm run build
# Build for development (with source maps)
npm run build:dev
# Preview production build
npm run preview
# Run linting
npm run lintThe project is configured for easy deployment to various platforms:
- Vercel: Includes
vercel.jsonconfiguration - Netlify: Compatible with standard build settings
- Custom Server: Includes Express server setup (
server.js)
Build command: npm run build
Output directory: dist
Contributions are welcome! Please follow these guidelines:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Follow the existing code style and conventions
- Write clear commit messages
- Update documentation as needed
- Test your changes thoroughly
- Push to your branch (
git push origin feature/amazing-feature) - Open a Pull Request with a clear description
[Add your license here]
Built with modern web technologies and best practices:
- shadcn/ui for beautiful, accessible components
- Radix UI for robust primitives
- Tailwind CSS for utility-first styling
- React ecosystem for powerful development experience
For issues, questions, or contributions:
- Open an issue on GitHub
- Check the documentation
- Review troubleshooting guides
Status: Active development | Version: 0.0.0 | Last Updated: January 2026