Skip to content

ibuildrun/hqstudio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HQ Studio

en ru

CI Release codecov GitHub release License: MIT

A comprehensive solution for an auto tuning studio: website, API, and desktop CRM application.

Demo Site | Releases | API Docs | Architecture | Git & CI/CD

Project Structure

├── HQStudio.API/          # ASP.NET Core 8.0 Backend
├── HQStudio.API.Tests/    # API Integration Tests
├── HQStudio.Web/          # Next.js 14 Frontend
├── HQStudio.Desktop/      # WPF Desktop Application
├── HQStudio.Desktop.Tests/# Desktop Unit Tests
└── docker-compose.yml     # Production Docker setup

Desktop Application Screenshots

Show screenshots

Login Window

Login

Dashboard (Dark Theme)

Dashboard Dark

Orders

Orders

Clients

Clients

Services

Services

Staff

Staff

Settings

Settings

Dashboard (Light Theme)

Dashboard Light

Quick Start

Requirements

  • .NET 8.0 SDK
  • Node.js 20+
  • Docker (optional)

Local Development

# Clone the repository
git clone https://github.com/randomu3/hqstudio.git
cd hqstudio

# Copy env files
cp .env.example .env

# Run API
cd HQStudio.API
dotnet run

# Run Web (in another terminal)
cd HQStudio.Web
npm install
npm run dev

# Run Desktop (Windows)
cd HQStudio.Desktop
dotnet run

Docker (development with hot-reload)

docker-compose -f docker-compose.dev.yml up --build

Docker (production)

docker-compose up --build -d

Tests

# API tests
dotnet test HQStudio.API.Tests

# Web tests
cd HQStudio.Web && npm test

# Desktop tests
dotnet test HQStudio.Desktop.Tests

CI/CD

The project uses a fully automated CI/CD pipeline:

Workflow Purpose
CI API, Web, Desktop tests + Codecov
Release Semantic versioning, CHANGELOG, Docker images
Pages Deploy Web to GitHub Pages
CodeQL Security analysis
Dependabot Auto-update dependencies

Conventional Commits

All commits must follow the format:

feat(api): add new feature
fix(web): fix bug
docs: update documentation

More details: CONTRIBUTING.md | Git & CI/CD

Technologies

Backend (API)

  • ASP.NET Core 8.0
  • Entity Framework Core
  • PostgreSQL / SQLite
  • JWT Authentication
  • Swagger/OpenAPI

Frontend (Web)

  • Next.js 14 (App Router)
  • React 18
  • TypeScript
  • Tailwind CSS
  • Framer Motion

Desktop

  • .NET 8.0 WPF
  • MVVM Pattern
  • Material Design

Environment Variables

See .env.example for the full list of variables.

License

MIT License — see LICENSE

Contributing

See CONTRIBUTING.md for information on how to contribute.

Security

See SECURITY.md for the security policy.

About

HQ Studio - Premium Auto Tuning CRM System. Web + Desktop + API monorepo

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •