Getting Started

rut-kit validates Chilean RUTs with descriptive errors. Instead of just true/false, it tells you exactly what failed.

Installation

npm

npm install rut-kit

pnpm

pnpm add rut-kit

bun

bun add rut-kit

Validate a RUT

import { validateRut } from 'rut-kit'

const result = validateRut('18.972.631-7')

if (result.valid) {
  console.log(result.rut) // '189726317'
} else {
  console.log(result.error) // 'invalidFormat' or 'invalidCheckDigit'
}

Format a RUT

import { formatRut } from 'rut-kit'

formatRut('189726317')              // '18972631-7'
formatRut('189726317', 'formatted') // '18.972.631-7'

With Zod

If you use Zod for form validation:

npm install rut-kit zod

import { rutSchema } from 'rut-kit/zod'

rutSchema.parse('18.972.631-7')
// '18972631-7'

Framework Agnostic

rut-kit works with any JavaScript framework. The integration examples are for frameworks we've tested, but you can use it with Vue, Svelte, Angular, etc. in the same way.

Next Steps

• Validation - When to use isValidRut vs validateRut
• Formatting - Output formats and data cleaning
• Zod - Schema for forms and APIs