diff --git a/README.md b/README.md index 815b9e0..502a7ff 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,7 @@ Languages are allowed only if they meet **all** of the following criteria: 2. **Type safety** - For Python, type hints with a strict type checker are mandatory. - Use TypeScript instead of JavaScript. + - Only `.ts` files are allowed, even for configs. 3. **Concurrency support** - Event-driven, async models only. - Thread-based models are not allowed. @@ -34,7 +35,7 @@ For Python, always use `uv`, `ruff`, and `ty` for code quality. ## Frontend -A **no-framework approach is mandatory**. Always focus on web standards. Web components composed of pure HTML, CSS, and JavaScript must be used. Third-party frameworks do not guarantee long-term security, stability, or continued adoption. +A **no-framework approach is mandatory**. Always focus on web standards. Web components composed of pure HTML, CSS, and TypeScript must be used. Third-party frameworks do not guarantee long-term security, stability, or continued adoption. By using only web components, we achieve: @@ -55,7 +56,9 @@ This means banned options include, but are not limited to: Currently approved options are: -- Lit -- Raw TypeScript +- [Lit](https://lit.dev) +- [Web Awesome](https://webawesome.com) -For all TypeScript projects, always prefer Deno over Node. Deno provides built-in support for type-checking, linting, formatting, and bundling. +For new and migrated TypeScript projects, use [Node.js](https://nodejs.org) (24 LTS) with [Vite+](https://viteplus.dev) (`vp`). Vite+ provides linting (Oxlint), formatting (Oxfmt), type checking, testing (Vitest), and bundling (tsdown). + +The only config files in each TypeScript project are `package.json`, `tsconfig.json`, and `vite.config.ts`.