wl-web-configs
Workleap's shared configuration library for web tooling. Provides pre-configured packages for ESLint, TypeScript, Rsbuild, Rslib, Stylelint, and Browserslist.
Philosophy
- No lock-in: Default configurations can always be extended or overridden
- By project type: Configurations are composed internally and offered per project type for simplicity
- ESM/ESNext by default: Targets modern JavaScript environments
- Distributed via NPM: Easy to adopt new features by bumping package versions
Supported Tools (Active)
| Tool |
Package |
Purpose |
| Browserslist |
@workleap/browserslist-config |
Browser targets for apps |
| ESLint |
@workleap/eslint-configs |
Code linting |
| Stylelint |
@workleap/stylelint-configs |
CSS linting |
| TypeScript |
@workleap/typescript-configs |
Type checking (linting only) |
| Rsbuild |
@workleap/rsbuild-configs |
Web application bundling |
| Rslib |
@workleap/rslib-configs |
Library bundling |
In maintenance mode (do not recommend): PostCSS, SWC, webpack, tsup
Quick Reference
Which Configuration to Use?
| Project Type |
ESLint |
TypeScript |
Bundler |
| Web app with React |
defineWebApplicationConfig |
web-application.json |
@workleap/rsbuild-configs |
| React library |
defineReactLibraryConfig |
library.json |
@workleap/rslib-configs |
| TypeScript library (no React) |
defineTypeScriptLibraryConfig |
library.json |
@workleap/rslib-configs |
| Monorepo workspace root |
defineMonorepoWorkspaceConfig |
monorepo-workspace.json |
N/A |
Browserslist (Apps Only)
pnpm add -D @workleap/browserslist-config browserslist
# .browserslistrc
extends @workleap/browserslist-config
Only for projects emitting application bundles. Libraries should not include Browserslist — the consuming application's Browserslist controls the final output targets.
To add custom browser targets while still using the shared config:
# .browserslistrc
extends @workleap/browserslist-config
IE 11
last 2 OperaMobile 12.1 versions
Reference Guide
For comprehensive setup guides, options, and examples, read the appropriate reference file:
- ESLint — references/eslint.md: Installation,
define*Config functions, rule categories, customization, and VS Code integration
- TypeScript — references/typescript.md: Config files by project type, compiler option overrides, path mappings, and CLI scripts
- Rsbuild — references/rsbuild.md: Dev/build/Storybook configs, predefined options, transformers, and Turborepo setup
- Rslib — references/rslib.md: Library build/dev/Storybook configs, bundleless vs bundle, transformers, and type declarations
- Stylelint — references/stylelint.md: Installation,
.stylelintrc.json setup, Prettier integration, and VS Code settings
Critical Rules
- Stick to documented APIs — these packages are thin wrappers, and undocumented options won't be passed through to the underlying tool
- Avoid maintenance-mode packages — PostCSS, SWC, webpack, and tsup configs won't receive new features; recommend the active alternatives (Rsbuild, Rslib, Stylelint) instead
- ESM by default — all configs target ESM/ESNext because Workleap's toolchain assumes modern JavaScript environments
- Browserslist for apps only — libraries omit Browserslist because the consuming application's config controls the final output targets
- TypeScript for linting — the shared TypeScript configs focus on type-checking; bundlers handle transpilation, so don't mix concerns
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: workleap-wl-web-configs-workleap-web-configs3description: wl-web-configs4---56# wl-web-configs78Workleap's shared configuration library for web tooling. Provides pre-configured packages for ESLint, TypeScript, Rsbuild, Rslib, Stylelint, and Browserslist.910## Philosophy1112- **No lock-in**: Default configurations can always be extended or overridden13- **By project type**: Configurations are composed internally and offered per project type for simplicity14- **ESM/ESNext by default**: Targets modern JavaScript environments15- **Distributed via NPM**: Easy to adopt new features by bumping package versions1617## Supported Tools (Active)1819| Tool | Package | Purpose |20|------|---------|---------|21| Browserslist | `@workleap/browserslist-config` | Browser targets for apps |22| ESLint | `@workleap/eslint-configs` | Code linting |23| Stylelint | `@workleap/stylelint-configs` | CSS linting |24| TypeScript | `@workleap/typescript-configs` | Type checking (linting only) |25| Rsbuild | `@workleap/rsbuild-configs` | Web application bundling |26| Rslib | `@workleap/rslib-configs` | Library bundling |2728**In maintenance mode** (do not recommend): PostCSS, SWC, webpack, tsup2930## Quick Reference3132### Which Configuration to Use?3334| Project Type | ESLint | TypeScript | Bundler |35|--------------|--------|------------|---------|36| Web app with React | `defineWebApplicationConfig` | `web-application.json` | `@workleap/rsbuild-configs` |37| React library | `defineReactLibraryConfig` | `library.json` | `@workleap/rslib-configs` |38| TypeScript library (no React) | `defineTypeScriptLibraryConfig` | `library.json` | `@workleap/rslib-configs` |39| Monorepo workspace root | `defineMonorepoWorkspaceConfig` | `monorepo-workspace.json` | N/A |4041### Browserslist (Apps Only)4243```bash44pnpm add -D @workleap/browserslist-config browserslist45```4647```text48# .browserslistrc49extends @workleap/browserslist-config50```5152Only for projects emitting application bundles. Libraries should not include Browserslist — the consuming application's Browserslist controls the final output targets.5354To add custom browser targets while still using the shared config:5556```text57# .browserslistrc58extends @workleap/browserslist-config59IE 1160last 2 OperaMobile 12.1 versions61```6263## Reference Guide6465For comprehensive setup guides, options, and examples, read the appropriate reference file:6667- **ESLint** — [references/eslint.md](references/eslint.md): Installation, `define*Config` functions, rule categories, customization, and VS Code integration68- **TypeScript** — [references/typescript.md](references/typescript.md): Config files by project type, compiler option overrides, path mappings, and CLI scripts69- **Rsbuild** — [references/rsbuild.md](references/rsbuild.md): Dev/build/Storybook configs, predefined options, transformers, and Turborepo setup70- **Rslib** — [references/rslib.md](references/rslib.md): Library build/dev/Storybook configs, bundleless vs bundle, transformers, and type declarations71- **Stylelint** — [references/stylelint.md](references/stylelint.md): Installation, `.stylelintrc.json` setup, Prettier integration, and VS Code settings7273## Critical Rules74751. **Stick to documented APIs** — these packages are thin wrappers, and undocumented options won't be passed through to the underlying tool762. **Avoid maintenance-mode packages** — PostCSS, SWC, webpack, and tsup configs won't receive new features; recommend the active alternatives (Rsbuild, Rslib, Stylelint) instead773. **ESM by default** — all configs target ESM/ESNext because Workleap's toolchain assumes modern JavaScript environments784. **Browserslist for apps only** — libraries omit Browserslist because the consuming application's config controls the final output targets795. **TypeScript for linting** — the shared TypeScript configs focus on type-checking; bundlers handle transpilation, so don't mix concerns8081---82> Converted and distributed by [TomeVault](https://tomevault.io/claim/workleap) — claim your Tome and manage your conversions.83<!-- tomevault:4.0:skill_md:2026-04-11 -->
tomevault-io