Skip to content
small-rules

small-rules

Oxlint-native linting for roblox-ts

small-rules

90 source-backed rules for React Luau, Ianitor lifecycle, Roblox UI conventions, and TypeScript quality.

Get startedView on GitHub
.oxlintrc.json
{
	"jsPlugins": ["@pobammer-ts/small-rules"],
	"rules": {
		"small-rules/ban-react-fc": "error",
		"small-rules/no-print": "error",
		"small-rules/prefer-early-return": "warn"
	}
}

Native oxlint speed, roblox-ts-specific checks, and fixes where repetitive cleanup should be automatic.

  • 90rules
  • 27fixable
  • 4categories
  • nativeoxlint plugin

Start here

Use the docs like a reference, not a landing page

Start with installation, copy a minimal config, then browse rules by category as you tighten the codebase.

1Quick StartInstall the plugin, register it in oxlint, and run the first pass.→2Configuration

Set severities and define what should block CI versus what should stay advisory.

→3ChangelogTrack rule additions and behavior changes before you upgrade.→

Browse

Pick the part of the codebase you want to harden

These category counts reflect the current plugin, not stale marketing numbers.

React Rules

31

Rules for React Luau components, hooks, and JSX patterns.

Browse rules

Roblox & Luau Rules

25

Rules for Roblox instances, Ianitor, Color3, UDim2, and other Roblox APIs.

Browse rules

Naming & Conventions

7

Rules for naming conventions, type style, and file naming.

Browse rules

General Logic & Style

27

Rules for code quality, control flow, and common pitfalls.

Browse rules

Why it exists

Focused rules for the failures oxlint does not catch by itself

The plugin is strongest where roblox-ts teams hit ecosystem-specific footguns and repeated review churn.

Oxlint-native

Ships as a real oxlint plugin, so you keep the native execution model instead of routing through ESLint.

Roblox-aware

Targets React Luau patterns, Ianitor lifecycle rules, UI conventions, and Roblox-specific APIs that generic linters miss.

Fixes where they help

27 rules currently expose code fixes or fixer suggestions for repetitive cleanup.

Start enforcing

Make the codebase argue less.

Pick the rules that match your standards. Let oxlint handle the repetitive review comments.

Open quick start

See how it works