From 067e96d715fd87e0b9e2ecf427780cf1e27cd878 Mon Sep 17 00:00:00 2001 From: Scofield Date: Tue, 4 Nov 2025 21:00:24 +0000 Subject: [PATCH] feat: add ultracite --- .cursor/hooks.json | 10 +++ .cursor/rules/ultracite.mdc | 129 ++++++++++++++++++++++++++++++++++++ biome.json | 37 +---------- bun.lock | 83 ++++++++++++++++------- package.json | 5 +- 5 files changed, 203 insertions(+), 61 deletions(-) create mode 100644 .cursor/hooks.json create mode 100644 .cursor/rules/ultracite.mdc diff --git a/.cursor/hooks.json b/.cursor/hooks.json new file mode 100644 index 000000000..d46927509 --- /dev/null +++ b/.cursor/hooks.json @@ -0,0 +1,10 @@ +{ + "version": 1, + "hooks": { + "afterFileEdit": [ + { + "command": "npx ultracite fix" + } + ] + } +} \ No newline at end of file diff --git a/.cursor/rules/ultracite.mdc b/.cursor/rules/ultracite.mdc new file mode 100644 index 000000000..07d76ffeb --- /dev/null +++ b/.cursor/rules/ultracite.mdc @@ -0,0 +1,129 @@ +--- +description: Ultracite Rules - AI-Ready Formatter and Linter +globs: "**/*.{ts,tsx,js,jsx,json,jsonc,html,vue,svelte,astro,css,yaml,yml,graphql,gql,md,mdx,grit}" +alwaysApply: false +--- + +# Ultracite Code Standards + +This project uses **Ultracite**, a zero-config Biome preset that enforces strict code quality standards through automated formatting and linting. + +## Quick Reference + +- **Format code**: `npx ultracite fix` +- **Check for issues**: `npx ultracite check` +- **Diagnose setup**: `npx ultracite doctor` + +Biome (the underlying engine) provides extremely fast Rust-based linting and formatting. Most issues are automatically fixable. + +--- + +## Core Principles + +Write code that is **accessible, performant, type-safe, and maintainable**. Focus on clarity and explicit intent over brevity. + +### Type Safety & Explicitness + +- Use explicit types for function parameters and return values when they enhance clarity +- Prefer `unknown` over `any` when the type is genuinely unknown +- Use const assertions (`as const`) for immutable values and literal types +- Leverage TypeScript's type narrowing instead of type assertions +- Use meaningful variable names instead of magic numbers - extract constants with descriptive names + +### Modern JavaScript/TypeScript + +- Use arrow functions for callbacks and short functions +- Prefer `for...of` loops over `.forEach()` and indexed `for` loops +- Use optional chaining (`?.`) and nullish coalescing (`??`) for safer property access +- Prefer template literals over string concatenation +- Use destructuring for object and array assignments +- Use `const` by default, `let` only when reassignment is needed, never `var` + +### Async & Promises + +- Always `await` promises in async functions - don't forget to use the return value +- Use `async/await` syntax instead of promise chains for better readability +- Handle errors appropriately in async code with try-catch blocks +- Don't use async functions as Promise executors + +### React & JSX + +- Use function components over class components +- Call hooks at the top level only, never conditionally +- Specify all dependencies in hook dependency arrays correctly +- Use the `key` prop for elements in iterables (prefer unique IDs over array indices) +- Nest children between opening and closing tags instead of passing as props +- Don't define components inside other components +- Use semantic HTML and ARIA attributes for accessibility: + - Provide meaningful alt text for images + - Use proper heading hierarchy + - Add labels for form inputs + - Include keyboard event handlers alongside mouse events + - Use semantic elements (`