Skip to content

README.md

Latest commit

 

History

History
92 lines (73 loc) · 2.67 KB

README.md

File metadata and controls

92 lines (73 loc) · 2.67 KB

Maestro Logo Maestro

Maestro is a modern, premium Agile Project Management and Help Desk solution designed to streamline workflows with style and efficiency. built with .NET 8 and React (Vite).

Maestro Demo

🌐 Live Demo

Experience Maestro live in your browser:
👉 Open Maestro Demo

Test Credentials:

  • Email: admin@duzey.com
  • Password: Password123!

✨ Features

  • 🎨 Premium UI/UX: Glassmorphism design, smooth transitions, and a polished aesthetic using Duzey's corporate identity.
  • 🌓 Dark & Light Mode: Fully supported theming engine with instant toggling.
  • 🌍 Localization (i18n): Native support for English and Turkish, extensible for more.
  • 📊 Interactive Dashboard: Real-time overview of projects, tickets, and sprint velocity.
  • 🔐 Secure Authentication: JWT-based auth with modern Login and Register pages.
  • 📋 Kanban & Backlog: Drag-and-drop boards, sprint planning, and backlog management.
  • 📱 Responsive: Collapsible sidebar and flexible layouts for all screen sizes.

🛠 Tech Stack

Server (Backend)

  • .NET 8 Web API
  • Entity Framework Core (PostgreSQL)
  • JWT Authentication

Client (Frontend)

  • React 19 + Vite
  • Vanilla CSS (Variables & Semantic Styling)
  • React Router v7
  • Axios & Context API

🚀 Getting Started

Prerequisites

  • .NET 8 SDK
  • Node.js (v18+)
  • PostgreSQL (or Docker container)

1. Database Setup

docker-compose up -d

Alternatively, update ConnectionStrings in appsettings.json to point to your local PostgreSQL instance.

2. Backend Setup

cd Maestro.Server
dotnet restore
dotnet ef database update
dotnet run

Server runs on http://localhost:5174

3. Frontend Setup

cd Maestro.Client
npm install
npm run dev

Client runs on http://localhost:5173

📂 Project Structure

Maestro/
├── Maestro.Server/       # .NET Core Web API
│   ├── Controllers/
│   ├── Models/
│   └── ...
├── Maestro.Client/       # React + Vite App
│   ├── src/
│   │   ├── components/
│   │   ├── context/
│   │   └── pages/
│   └── ...
└── docker-compose.yml    # PostgreSQL Config

🤝 Contributing

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