isentinel Preferences

Opinionated tooling and patterns for roblox-ts development.

Quick Summary

Package Manager (pnpm)

Use pnpm as the package manager. Can use bun as runtime for scripts.

@antfu/ni

Use @antfu/ni for unified package manager commands (It auto-detects the package manager (pnpm/npm/yarn/bun) based on lockfile):

TypeScript

Use @isentinel/tsconfig with the roblox preset. Strict mode plus additional checks:

• exactOptionalPropertyTypes
• noUncheckedIndexedAccess
• noPropertyAccessFromIndexSignature
• noImplicitOverride
• noImplicitReturns
• noFallthroughCasesInSwitch

json
1{
2	"extends": "@isentinel/tsconfig/roblox"
3}

Linting

Use @isentinel/eslint-config. No Prettier - ESLint handles formatting.

ts
1// eslint.config.ts
2import { isentinel } from "@isentinel/eslint-config";
3
4export default isentinel();

Fix errors with nr lint --fix.

Error Handling

Prefer assertions over silent failing. Fail fast, fail loud.

See error-handling.md for patterns.

Test-Driven Development

Red → Green → Refactor:

1. Write a failing test
2. Write minimal code to pass
3. Refactor with test protection

Simplicity Rules (in order)

1. Passes all tests
2. Expresses intent clearly
3. Contains no duplication
4. Has minimum elements

Three similar lines of code is better than a premature abstraction.

See testing.md for Jest-roblox setup.

References