web-development-guide

Configure TypeScript, Biome, Vitest, TypeDoc, and pnpm conventions for web projects.

3|Updated Jun 15, 2026
One-click install
npx skills add https://github.com/patrickserrano/lacquer --skill web-development-guide-patrickserrano
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: web-development-guide
Source: https://github.com/patrickserrano/lacquer/tree/main/profiles/web/skills/web-development-guide
Command: npx skills add https://github.com/patrickserrano/lacquer --skill web-development-guide-patrickserrano

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Web projects drift into inconsistent tooling setups: relaxed TypeScript strictness, linters that pass on warnings, package managers resolving unpinned binaries, and CI gates that disagree with local git hooks. This Skill encodes one enforced set of conventions so every web component builds, lints, tests, and documents the same way. ## Core Features & Use Cases - Strict TypeScript configuration: Extend a synced tsconfig.base.json with framework-specific options without relaxing strict flags, and use @ts-expect-error instead of @ts-ignore. - Biome linting and formatting: Run the local binary via ./node_modules/.bin/biome with --error-on-warnings so warning-severity rules actually gate CI, and keep tools as real devDependencies rather than relying on npx fallbacks. - Testing, docs, and CI alignment: Set up Vitest coverage thresholds, TSDoc plus TypeDoc validation, required package.json scripts, lefthook git hooks, and Turborepo task graphs that match what web-ci.yml invokes. - Use Case: When migrating a project from npm to pnpm, follow the guidance to run pnpm import, move settings into pnpm-workspace.yaml, declare onlyBuiltDependencies, and check vercel.json for a pinned npm installCommand that would break deploys. ## Quick Start Use the web-development-guide skill to review my Next.js project's package.json scripts, tsconfig, and Biome setup against the required conventions.

Frequently Asked Questions about web-development-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure TypeScript strict mode for a Next.js or Vite project?▼

Extend the synced tsconfig.base.json in your project tsconfig and add framework options like lib, moduleResolution bundler, and jsx. Never relax base flags such as strict, noUncheckedIndexedAccess, or exactOptionalPropertyTypes; fix the code instead.

How to migrate a project from npm to pnpm safely?▼

Run pnpm import to preserve resolved versions from package-lock.json, then delete the npm lockfile. Move settings like overrides into pnpm-workspace.yaml, declare onlyBuiltDependencies for install scripts, and check vercel.json for a pinned npm ci installCommand.

Why does npx biome pass lint when Biome is not installed?▼

npx silently downloads or resolves a global binary when the project has none, so the lint step runs an unpinned version. Invoke ./node_modules/.bin/biome directly and keep @biomejs/biome as a real devDependency so a missing tool fails loudly.

Does Turborepo run tasks in the workspace root package?▼

No, turbo skips the root package for ordinary tasks. When the root is a real app, declare //# tasks like //#build in turbo.json, and verify with turbo run build --dry=json that the root package appears in the task list.

Why does biome ci pass with warnings outstanding?▼

Plain biome ci fails only on error-severity rules, so warning rules print and pass. Add --error-on-warnings to both CI and the pre-commit hook so rules like noExcessiveCognitiveComplexity and noNonNullAssertion actually gate the build.

How do I handle build-time secrets in a Next.js CI workflow?▼

List secret names in the manifest's build_env array so the synced CI declares them from GitHub Actions secrets. Commit names only, never values, and store real secrets in the deploy platform's environment settings.