Evento - Social Events Management Platform

Create Events. Connect People. Build Communities.

Overview

Evento is a modern, social-first event management platform. It's designed to make event organizing friction-free and fun, whether you're bringing together five friends or five hundred attendees. It features a built-in Bitcoin Lightning wallet allowing for frictionless movement of money between event goers and hosts.

This README is kept intentionally high-level and focused on local development basics.

Key Features

• 🎉 Seamless Event Creation - Intuitive event builder with rich text editing
• 👥 Interactive Guest Management - RSVP tracking, check-ins*, and guest lists
• 🎨 Beautiful UI - Modern, responsive design with minimalistic branding
• ⚡ Bitcoin Wallet - In-app Bitcoin wallet powered by Breez SDK for Lightning payments
• 📧 Email Communications - Targeted email blasts with scheduling
• 📍 Location Services - Google Maps integration with dynamic location display
• 🎵 Music Integration - Embed playlists from Spotify and Wavlake
• 📸 Event Gallery - Share and react to event photos
• 💬 Live Chat - Real-time messaging for DMs and group chats*

Quick Start

Prerequisites

• Node.js 18.x or later
• PNPM package manager
• Supabase account
• Google Maps API key

Installation

1. Clone the repository

   git clone https://github.com/sevenlabsxyz/evento-client.git
   cd evento-client

2. Install dependencies

   pnpm install

3. Start the development server

   pnpm dev

4. Open your browser

   Navigate to http://localhost:3000

Development

Available Scripts

# Start development server
pnpm dev

# Run tests
pnpm test

# Run tests in watch mode
pnpm test:watch

# Type checking
pnpm tsc

# Lint code
pnpm lint

# Format code
pnpm format

# Build for production
pnpm build

# Start production server
pnpm start

Development Workflow

1. Ensure you're on the dev branch

   git checkout dev
   git pull origin dev

2. Create a new branch for your feature/fix

   git checkout -b feature/your-feature-name

3. Make your changes following our coding standards

4. Run tests to ensure everything works

   pnpm test
   pnpm tsc

5. Commit your changes with a descriptive message

   git commit -m "feat: add new feature"

6. Push and create a Pull Request to the dev branch

API Integration

The application uses a RESTful API for backend communication. API endpoints are proxied through Next.js API routes for security and CORS handling.

Contributing

We love contributions! Please read our Contributing Guidelines before submitting a Pull Request.

Quick Contribution Guide

1. Fork the repository
2. Clone and switch to dev branch (git clone <repo> && cd evento-client && git checkout dev)
3. Create your feature branch (git checkout -b feature/AmazingFeature)
4. Commit your changes (git commit -m 'feat: add some AmazingFeature')
5. Push to the branch (git push origin feature/AmazingFeature)
6. Open a Pull Request to the dev branch

Note: All PRs should target the dev branch, not main.

Community

• Report bugs by opening an issue

License

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