feat: Switch to oxlint and dprint

Author: dawsontoth

.github/CONTRIBUTING.MD

@@ -2,7 +2,6 @@
 
 Thank you for your interest in contributing! This document explains how to set up your environment, make changes safely, and submit high‑quality pull requests.
 
-
 ## Prerequisites
 
 - Node.js (see .nvmrc file)
@@ -16,7 +15,6 @@ pnpm install
 pnpm prepare   # installs Husky if hooks are present
 ```
 
-
 ## Development workflow
 
 - Start the dev server: `pnpm dev`
@@ -27,7 +25,6 @@ pnpm prepare   # installs Husky if hooks are present
 
 Build output goes to `web/` and should not be edited directly.
 
-
 ## Environment configuration
 
 We use Vite modes and `.env.*` files. You can `cp .env.local.example .env.local` to get started fast.
@@ -42,7 +39,6 @@ Some commonly used variables:
 
 See `.env.prod` for a production example. For local development, create `.env.local` based on `.env.local.example`.
 
-
 ## Commit conventions
 
 We use Conventional Commits and commitlint to keep history clean and to power semantic-release.
@@ -64,7 +60,6 @@ chore(ci): update workflow names
 
 Useful types include: feat, fix, perf, refactor, chore, docs, style, test, build, ci, revert.
 
-
 ## Testing
 
 - Framework: Vitest (see `vitest.config.ts`)
@@ -73,17 +68,14 @@ Useful types include: feat, fix, perf, refactor, chore, docs, style, test, build
 
 Where practical, add or update unit tests for your changes.
 
-
 ## Linting and style
 
-- ESLint is configured in `eslint.config.js` with TypeScript, React Hooks, and React Refresh plugins.
-- Run: `pnpm lint`
-- Auto-fix: `pnpm exec eslint . --fix`
+- Linting: OXLint (`pnpm lint`, `pnpm lint:fix`)
+- Formatting: dprint (`pnpm format`, `pnpm format:fix`)
 - Type-check: `pnpm exec tsc -b`
 
 We use Tailwind CSS; prefer utility classes and shared components for consistency.
 
-
 ## Generating the API types (SDK)
 
 If your change depends on updated Central Manager API types:
@@ -95,7 +87,6 @@ pnpm update-sdk
 
 This fetches the OpenAPI spec into `dist/central-manager.json` and generates `src/integrations/api/api.gen.d.ts`.
 
-
 ## Branching and pull requests
 
 - Create feature branches from the main development branch.
@@ -106,15 +97,13 @@ This fetches the OpenAPI spec into `dist/central-manager.json` and generates `sr
 
 Releases are automated from the `stage` branch via semantic-release.
 
-
 ## Code review guidelines
 
 - Prefer clear, readable code over “clever” code.
 - Add comments where intent isn’t obvious.
 - Avoid introducing unused dependencies.
 - Keep changes backward compatible when feasible.
 
-
 ## Questions
 
 If you’re unsure about anything, open a draft PR early or start a discussion. We’re happy to help get you unblocked quickly.

.husky/pre-commit

@@ -1,2 +1,3 @@
 pnpm test
 pnpm lint
+pnpm format:staged

.oxlintrc.json

@@ -0,0 +1,6 @@
+{
+	"ignorePatterns": [
+		"src/integrations/api/*.gen.d.ts",
+		"src/assets/**"
+	]
+}

.prettierrc

@@ -8,7 +8,7 @@
 SHELL := /bin/bash
 PNPM  := pnpm
 
-.PHONY: help install prepare dev dev-local build build-dev build-stage build-prod build-local preview lint lint-fix typecheck test test-watch update-sdk clean
+.PHONY: help install prepare dev dev-local build build-dev build-stage build-prod build-local preview lint lint-fix format format-fix typecheck test test-watch update-sdk clean
 
 help:
 	@echo "Available targets:"
@@ -22,8 +22,10 @@ help:
 	@echo "  build-prod    - Build using --mode prod"
 	@echo "  build-local   - Build using --mode localstudio"
 	@echo "  preview       - Preview the built app from web/"
-	@echo "  lint          - Run ESLint"
-	@echo "  lint-fix      - Run ESLint with --fix"
+	@echo "  lint          - Run code linter to check files"
+	@echo "  lint-fix      - Run code linter and automatically apply fixes, where possible"
+	@echo "  format        - Check formatting of code"
+	@echo "  format-fix    - Fix formatting of code automatically"
 	@echo "  typecheck     - Run TypeScript project references build (type-check)"
 	@echo "  test          - Run tests once (Vitest)"
 	@echo "  test-watch    - Run tests in watch mode"
@@ -64,7 +66,13 @@ lint:
 	$(PNPM) lint
 
 lint-fix:
-	$(PNPM) exec eslint . --fix
+	$(PNPM) lint:fix
+
+format:
+	$(PNPM) format
+
+format-fix:
+	$(PNPM) format:fix
 
 typecheck:
 	$(PNPM) exec tsc -b

Makefile

@@ -8,10 +8,10 @@ It is also the source for the bundled “Local Studio” UI that ships with the
 - Tech stack: React, Vite, TypeScript, Tailwind CSS, TanStack Router/Query/Table
 - Package manager: pnpm (see package.json `packageManager`)
 
-
 ## Quick start (develop this repo)
 
 Prerequisites:
+
 - Node.js (see .nvmrc)
 - pnpm (the version in `package.json#packageManager` is recommended)
 
@@ -27,17 +27,18 @@ pnpm dev:local
 Builds are emitted to `web/` (see `vite.config.ts`). The `web/` directory is build output; don’t edit it by hand.
 
 Common scripts:
+
 - `pnpm dev` — start Vite dev server
 - `pnpm dev:local` — start in Local Studio mode
 - `pnpm build` — type-check then build for production
 - `pnpm build:dev|stage|prod|local` — build for a specific mode
 - `pnpm preview` — serve the built `web/`
 - `pnpm test` / `pnpm test:watch` — run unit tests (Vitest)
-- `pnpm lint` — run ESLint
+- `pnpm lint` — run code linting (use `pnpm lint:fix` to write changes)
+- `pnpm format` — check formatting of code (use `pnpm format:fix` to write changes)
 
 Tip: prefer using the Makefile shortcuts in `Makefile` if you like `make` (e.g. `make dev`, `make build-prod`).
 
-
 ## Using this app via Harper (Local Studio)
 
 If you would like to run the Studio UI locally via Harper itself, install and start Harper with Local Studio enabled. At runtime, Harper will serve the compiled UI from this repository.
@@ -46,12 +47,11 @@ Open your harperdb-config.yaml and enable localStudio:
 
 ```yaml
 localStudio:
-	enabled: true
+  enabled: true
 ```
 
 Then visit http://localhost:9925 (or wherever you've set your operations port) to access the Local Studio. The default dev URL used by this repo is `http://localhost:9925` (see `VITE_LOCAL_STUDIO_DEV_URL`).
 
-
 ## Environments and configuration
 
 This project uses Vite environment files and modes. You can pass `--mode <name>` to Vite to pick a `.env.<name>` file. Some keys you may encounter:
@@ -72,10 +72,10 @@ VITE_ENV_NAME=dev
 ```
 
 Notes:
+
 - A production example is in `.env.prod`.
 - Building for a specific environment uses the matching mode: `pnpm build:dev`, `pnpm build:stage`, or `pnpm build:prod`.
 
-
 ## OpenAPI SDK generation
 
 This repository can generate TypeScript definitions from the Central Manager OpenAPI schema.
@@ -91,29 +91,30 @@ HDB_ADMIN_PASSWORD_FOR_OPENAPI=<password>
 ```
 
 What the script does:
-1) Downloads `${VITE_CENTRAL_MANAGER_API_URL}/openapi` into `./dist/central-manager.json` using the admin credentials
-2) Runs `openapi-typescript` to generate `src/integrations/api/api.gen.d.ts`
 
+1. Downloads `${VITE_CENTRAL_MANAGER_API_URL}/openapi` into `./dist/central-manager.json` using the admin credentials
+2. Runs `openapi-typescript` to generate `src/integrations/api/api.gen.d.ts`
 
 ## Linting, formatting, and type-checking
 
-- ESLint: configured in `eslint.config.js` with TypeScript, React Hooks, and React Refresh plugins
+- Linting: OXLint
 - TypeScript: strict project references via `tsconfig.json` and `tsconfig.app.json`
 - Tailwind CSS: configured via `@tailwindcss/vite`; styles are colocated with components
 
 Run locally:
-- `pnpm lint`
-- `pnpm exec eslint . --fix` to auto-fix
-- `pnpm exec tsc -b` to type-check
 
+- `pnpm lint` — run code linter
+- `pnpm lint:fix` — auto-fix lint issues where possible
+- `pnpm format` — check code formatting
+- `pnpm format:fix` — write code formatting changes where possible
+- `pnpm exec tsc -b` — type-check
 
 ## Testing
 
 - Test runner: Vitest (see `vitest.config.ts`)
 - Run once: `pnpm test`
 - Watch mode: `pnpm test:watch`
 
-
 ## Commit conventions and release
 
 This repo enforces Conventional Commits via commitlint. Please format your commit messages like:
@@ -130,19 +131,16 @@ chore(ci): update workflow names
 
 Useful commit types include: feat, fix, perf, refactor, chore, docs, style, test, build, ci, revert.
 
-
 ## Contributing
 
 Please see .github/CONTRIBUTING.MD for detailed guidelines, including how to run checks locally and how to structure your pull requests.
 
-
 ## Troubleshooting
 
 - Dev server won’t start: ensure Node 20+ and pnpm installed; remove `node_modules` and reinstall.
 - API calls failing in dev: verify `VITE_CENTRAL_MANAGER_API_URL` and any required auth are correct for your environment/mode.
 - Local Studio not showing: ensure your Harper process has `localStudio: { enabled: true }` and is listening on the port you expect (default 9925).
 
-
 ## License
 
 This project is proprietary to Harper. If you’re unsure about usage or licensing, please contact the maintainers.

README.md

@@ -0,0 +1,34 @@
+{
+	"typescript": {
+		"quoteStyle": "preferSingle",
+		"jsx.quoteStyle": "preferDouble",
+		"useTabs": true,
+		"useBraces": "always"
+	},
+	"json": {
+		"useTabs": true
+	},
+	"markdown": {},
+	"markup": {},
+	"yaml": {
+		"quotes": "preferSingle"
+	},
+	"graphql": {
+		"useTabs": true
+	},
+	"excludes": [
+		"**/node_modules",
+		"**/*-lock.json",
+		"pnpm-lock.yaml",
+		"src/assets/**",
+		"src/integrations/api/api.gen.d.ts"
+	],
+	"plugins": [
+		"https://plugins.dprint.dev/typescript-0.95.13.wasm",
+		"https://plugins.dprint.dev/json-0.21.0.wasm",
+		"https://plugins.dprint.dev/markdown-0.20.0.wasm",
+		"https://plugins.dprint.dev/g-plane/markup_fmt-v0.25.1.wasm",
+		"https://plugins.dprint.dev/g-plane/pretty_yaml-v0.5.1.wasm",
+		"https://plugins.dprint.dev/g-plane/pretty_graphql-v0.2.3.wasm"
+	]
+}

dprint.json

@@ -16,7 +16,11 @@
 		"release": "semantic-release",
 		"update-sdk": "dotenv -e .env.local -- npm run update-sdk:fetch && npx -y openapi-typescript --root-types --alphabetize --enum ./dist/central-manager.json -o src/integrations/api/api.gen.d.ts",
 		"update-sdk:fetch": "mkdir -p dist && curl --location \"$VITE_CENTRAL_MANAGER_API_URL/openapi\" -u \"$HDB_ADMIN_USERNAME_FOR_OPENAPI:$HDB_ADMIN_PASSWORD_FOR_OPENAPI\" -o ./dist/central-manager.json",
-		"lint": "eslint .",
+		"lint": "oxlint .",
+		"lint:fix": "oxlint . --fix",
+		"format": "dprint check",
+		"format:fix": "dprint fmt",
+		"format:staged": "dprint check --staged",
 		"prepare": "husky",
 		"test": "vitest run",
 		"test:watch": "vitest",
@@ -72,7 +76,6 @@
 	"devDependencies": {
 		"@commitlint/cli": "^20.0.0",
 		"@commitlint/config-conventional": "^20.0.0",
-		"@eslint/js": "^9.19.0",
 		"@semantic-release/commit-analyzer": "^13.0.0",
 		"@semantic-release/github": "^12.0.0",
 		"@semantic-release/release-notes-generator": "^14.0.0",
@@ -84,16 +87,13 @@
 		"@vitejs/plugin-react": "^5.0.0",
 		"@vitest/coverage-v8": "^4.0.0",
 		"dotenv-cli": "^11.0.0",
-		"eslint": "^9.19.0",
-		"eslint-plugin-react-hooks": "^7.0.0",
-		"eslint-plugin-react-refresh": "^0.4.18",
-		"globals": "^16.0.0",
+		"dprint": "^0.50.2",
 		"harperdb": "4.7.11",
 		"husky": "^9.1.7",
 		"jsdom": "^27.0.0",
+		"oxlint": "^1.32.0",
 		"semantic-release": "^25.0.0",
 		"typescript": "~5.9.0",
-		"typescript-eslint": "^8.22.0",
 		"vite": "^7.0.0",
 		"vitest": "^4.0.0"
 	},