An open API service indexing awesome lists of open source software.

https://github.com/asafr-dev/supportdesk-admin-ui

Admin dashboard for the SupportDesk API: ticket list/detail, filters, status updates, loading/error states, CI.
https://github.com/asafr-dev/supportdesk-admin-ui

ci dashboard frontend react rest-api tailwindcss tanstack-query typescript vite

Last synced: 19 days ago
JSON representation

Admin dashboard for the SupportDesk API: ticket list/detail, filters, status updates, loading/error states, CI.

Awesome Lists containing this project

README

          

SupportDesk Admin UI


Admin UI (demo) for SupportDesk API β€” built with React, TypeScript, Vite, Tailwind, TanStack Query for cache/retries/loading states, and strict runtime validation with Zod; consumes the standalone ticketing API.


CI
CodeQL
Coverage
CodeFactor
License

## 🎬 Demo

**Live demo:** [supportdesk-admin-ui-demo.up.railway.app](https://supportdesk-admin-ui-demo.up.railway.app)

## πŸš€ Quickstart

### Requirements

- Linux
- Node 20+
- Docker

### Run locally

1. Start the API – from [SupportDesk API](https://github.com/asafr-dev/supportdesk-api#quickstart) repo.
2. Start this UI:

```bash
npm ci
npm run dev
```

Open: [http://localhost:9000](http://localhost:9000)

## πŸ§ͺ How to test

After installing dependencies:

```bash
npm run check
```

## πŸ—‚οΈ Project structure

For the full directory map and β€œwhat goes where” conventions, see
[STRUCTURE.md](docs/STRUCTURE.md).

- `src/lib/api.ts` – API client
- `src/lib/schemas.ts` – Zod runtime schemas
- `nginx/default.conf.template` – `/api` reverse-proxy
- `Dockerfile` – builds + serves + proxies
- `docs/` – longer-form documentation (architecture, API contract)

## πŸ“š Documentation

See [documentation](docs/)

## 🀝 Contributing

See the [contributing guidelines](https://github.com/asafr-dev/.github/blob/main/CONTRIBUTING.md)

## πŸ”’ Security

See the [security policy](https://github.com/asafr-dev/.github/blob/main/SECURITY.md)

## πŸ“„ License

See [LICENSE](LICENSE)