11# Evently - Event Management Application
22
3- A modern, full-stack event management platform built with .NET and React, designed to streamline event organization and management processes.
3+ A modern, full-stack event management platform built with .NET and React, designed to streamline event organization and
4+ management processes.
45
56## 📋 Features
7+
68- 🎫 ** Event Creation & Management** - Create and manage events with detailed information
79- 👥 ** User Authentication** - Google OAuth integration
810- 📱 ** QR Code Support** - Generate and scan QR codes for events
@@ -12,17 +14,20 @@ A modern, full-stack event management platform built with .NET and React, design
1214- 📱 ** Progressive Web App** - Mobile-friendly experience
1315- 🔍 ** Advanced Search & Filtering** - Find events easily
1416
15-
1617## 🚀 Quick Start
1718
1819### 🌐 Live Demo
19- Experience Evently in action: [ Website] ( https://ca-evently-prod-sea.graybush-4e3751bc.southeastasia.azurecontainerapps.io/ )
20+
21+ Experience Evently in
22+ action: [ Website] ( https://ca-evently-prod-sea.graybush-4e3751bc.southeastasia.azurecontainerapps.io/ )
2023
2124### 🐳 Docker (Recommended)
25+
2226Get up and running in minutes with Docker:
2327
2428Update your ` docker-compose.yml ` with your email and Google OAuth Client credentials. If omitted,
2529the application can still run, just that the authentication and email features won't work:
30+
2631``` yaml
2732environment :
2833 # ... other environment variables ...
@@ -42,15 +47,17 @@ docker-compose up --build
4247# Website: http://localhost:4000
4348```
4449
45-
4650## 🛠 Tech Stack
51+
4752### ⚙️ Backend
53+
4854- ** Framework** : .NET 9.0 with ASP.NET Core
4955- ** Language** : C# 13.0
5056- ** UI Framework** : Blazor Server components
5157- ** Architecture** : Web API with MVC pattern
5258
5359### 🎨 Frontend
60+
5461- ** Framework** : React 19
5562- ** Language** : TypeScript 5
5663- ** Routing** : TanStack Router v1
@@ -59,13 +66,15 @@ docker-compose up --build
5966- ** Build Tool** : Vite 7
6067
6168### 🏗️ Infrastructure & DevOps
69+
6270- ** CI/CD** : GitHub Actions
6371- ** Cloud** : Azure
6472- ** IAC** : Terraform
6573
6674## 🏁 Getting Started
6775
6876### Prerequisites
77+
6978- .NET 9.0 SDK
7079- Node.js (with npm/pnpm)
7180- Docker (optional)
@@ -97,13 +106,16 @@ docker-compose up --build
97106 ` ` `
98107
99108# # 🧪 Testing
109+
100110The project includes a comprehensive testing setup:
111+
101112- ** Testing Framework** : Vitest 3.2.4
102113- ** React Testing** : React Testing Library 16.3.0
103114- ** DOM Testing** : Testing Library DOM 10.4.1
104115- ** User Interaction Testing** : User Event 14.6.1
105116
106117Run tests:
118+
107119` ` ` bash
108120# Backend tests
109121dotnet test tests/Evently.Server.Test/
@@ -112,23 +124,28 @@ dotnet test tests/Evently.Server.Test/
112124cd src/evently.client && pnpm test
113125` ` `
114126
115-
116127# # 🔧 Development
128+
117129# ## Code Quality
130+
118131The project maintains high code quality standards with:
132+
119133- ** ESLint** : JavaScript/TypeScript linting
120134- ** Prettier** : Code formatting
121135- ** EditorConfig** : Consistent coding styles
122136- ** TypeScript** : Strong typing for frontend
123137
124138# ## Build Tools
139+
125140- ** Vite** : Fast development server and build tool
126141- ** Makefile** : Standardized build commands
127142- ** Docker Compose** : Development environment orchestration
128143
129144# ## 📁 Project Structure
130- The project follows a ** Feature Folder Structure** or ** Vertical Slice Architecture** pattern,
131- organizing code by business features rather than technical layers. This approach encourages modularity and separation of concerns.
145+
146+ The project follows a ** Feature Folder Structure** or ** Vertical Slice Architecture** pattern,
147+ organizing code by business features rather than technical layers. This approach encourages modularity and separation of
148+ concerns.
132149
133150```
134151evently/
0 commit comments