Evento - Event Management Platform

A modern, full-stack event management platform built with Next.js 15, TypeScript, and PostgreSQL.

📑 Table of Contents

• 🚀 Features
• 🎥 Demo
• 🛠️ Tech Stack
• 📦 Installation
• 🔧 Development
• 🏗️ Project Structure
• 🔒 Security Features
• 🚀 Deployment
• 📝 License
• 🤝 Contributing
• 📧 Contact

🚀 Features

• Modern Tech Stack

  • Next.js 15 with App Router
  • TypeScript for type safety
  • PostgreSQL with Prisma ORM
  • Tailwind CSS for styling
  • Framer Motion for animations

• Event Management

  • Create and manage events
  • Event details with rich descriptions
  • Location and date management
  • Image upload support
  • Organizer information

• User Experience

  • Responsive design
  • Smooth animations
  • Pagination
  • Loading states
  • Error handling

🎥 Demo

🛠️ Tech Stack

• Frontend

  • Next.js 15
  • React 19
  • TypeScript
  • Tailwind CSS
  • Framer Motion
  • Lottie React

• Backend

  • Next.js API Routes
  • Prisma ORM
  • PostgreSQL
  • Zod for validation

• Development

  • ESLint
  • TypeScript
  • Turbopack
  • Tailwind CSS

📦 Installation

1. Clone the repository:

   git clone https://github.com/aminetiouk/evento.git
   cd evento

2. Install dependencies:

   npm install

3. Set up environment variables: Create a .env file in the root directory with:

   DATABASE_URL="postgresql://user:password@localhost:5432/evento"
   

4. Set up the database:

   npx prisma db push
   npx prisma generate

5. Run the development server:

   npm run dev

🔧 Development

• Database Migrations

  npx prisma migrate dev

• Type Generation

  npx prisma generate

• Linting

  npm run lint

🏗️ Project Structure

evento/
├── app/                   # Next.js app directory
│   ├── api/               # API routes
│   ├── events/            # Event pages
│   └── page.tsx           # Home page
├── components/            # React components
├── lib/                   # Utility functions
├── prisma/                # Database schema
└── public/                # Static assets

🔒 Security Features

• Type-safe database queries with Prisma
• Input validation with Zod
• Environment variable protection
• API route protection
• CORS configuration
• Rate limiting (to be implemented)
• Authentication (to be implemented)

🚀 Deployment

1. Build the application:

   npm run build

2. Start the production server:

   npm start

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📧 Contact

• Name - @aminetiouk
• Project Link: @evento