Eventownik Solvro – Frontend

Aplikacja do organizacji wydarzeń dla studentów Politechniki Wrocławskiej

Odwiedź aplikację • Dokumentacja • Backend V2 • Backend V3

---

O projekcie

Eventownik Solvro to aplikacja webowa tworzona przez KN Solvro, której celem jest ułatwienie organizacji wydarzeń studenckich na Politechnice Wrocławskiej.

Aplikacja umożliwia tworzenie i konfigurację wydarzeń, zarządzanie uczestnikami, formularzami oraz komunikacją mailową, tworząc kompletne rozwiązanie dla organizatorów wydarzeń.

Funkcjonalności

• Tworzenie i konfiguracja wydarzeń
• Dodawanie współorganizatorów
• Definiowanie atrybutów uczestników
• Zarządzanie uczestnikami
• Tworzenie formularzy rejestracyjnych
• Tworzenie szablonów maili
• Wysyłka maili (spersonalizowanych oraz wyzwalanych)

Uruchomienie lokalne

Wymagania

• Node.js (zalecana wersja LTS)
• npm (dostarczany z Node.js)

Instalacja

1. Sklonuj repozytorium

   git clone https://github.com/Solvro/web-eventownik-v2.git
   cd web-eventownik-v2

2. Zainstaluj zależności

   npm install

3. Uruchom serwer deweloperski

   npm run dev

4. Otwórz przeglądarkę i przejdź do http://localhost:3000

Dostępne skrypty

Komenda	Opis
npm run dev	Uruchamia serwer deweloperski (Turbopack)
npm run build	Buduje aplikację do produkcji
npm run start	Uruchamia zbudowaną aplikację
npm run lint	Sprawdza kod za pomocą ESLint
npm run format	Formatuje kod za pomocą Prettier
npm run format:check	Sprawdza formatowanie kodu
npm run typecheck	Sprawdza typy TypeScript
npm run test	Uruchamia testy (Vitest)
npm run test:ui	Uruchamia UI Vitest

Stack technologiczny

• Framework: Next.js (v16) + React (v19)
• Język: TypeScript
• Stylowanie: Tailwind CSS
• Komponenty UI: shadcn/ui
• Ikony: Lucide React
• Edytor WYSIWYG: Tiptap
• Global state: Jotai
• Walidacja: Zod
• Animacje: Motion
• Testy : Vitest + Playwright

Kontrybucja

Chcesz pomóc w rozwoju Eventownika? Super.

1. Sforkuj repozytorium (jeśli nie jesteś w zespole)
2. Stwórz branch dla swojej zmiany
3. Commituj zmiany zgodnie z Conventional Commits
4. Zpushuj branch
5. Otwórz Pull Request
6. Zlinkuj issues, które chcesz rozwiązać (jeśli takie są)

Format commitów

Stosujemy standard Conventional Commits.

<type>(opcjonalny scope): opis w czasie teraźniejszym

Przykłady

feat(events): add event duplication
fix(forms): correct validation edge case
docs: update readme
refactor(mail): simplify editor logic
test(events): add missing unit tests

Zgłaszanie problemów

• Problemy dotyczące frontendu zgłaszaj w tym repozytorium.
• Problemy dotyczące backendu (API, logika serwera, baza danych) zgłaszaj w repozytorium backendu: https://github.com/Solvro/backend-eventownik-v2

Aktualny zespół

• Maciej Król – Frontend Tech Lead
• Antoni Czaplicki – Frontend Developer
• Bohdan Koshkin – Frontend Developer
• Bohdan Moshenets – Frontend Developer
• Maciej Malinowski – Frontend Developer
• Maksymilian Tarasiuk - Frontend Developer
• Wincenty Wensker - UI/UX Designer
• Maciej Talarczyk – UI/UX Designer

Kontakt

• Email: kn.solvro@pwr.edu.pl
• Organizacja: KN Solvro
• Strona: https://solvro.pwr.edu.pl

---

Stworzone przez KN Solvro dla studentów Politechniki Wrocławskiej