Number Field

Numeric stepper with increment and decrement buttons. Enforces min/max boundaries and configurable step increments.

import{ NumberField } from "@pepulux/ui"

Default — controlled value

Value: 1

Custom step

Increment and decrement in steps larger than 1.

Increases in $10 steps

Minimum 5 seats

Min / Max boundaries

Decrement and increment buttons disable automatically at the boundary.

Buttons disable at boundaries 1 and 5

Error state

At least 1 ticket is required

Disabled

Contact sales to change

With hint text

Added before and after each session

Props

PropTypeDefaultDescription
valuenumber—Controlled value
onChange(value: number) => void—Called when value changes via buttons or direct input
minnumber—Minimum allowed value — disables decrement at boundary
maxnumber—Maximum allowed value — disables increment at boundary
stepnumber1Amount added or subtracted per click
labelstring—Field label above the control
hintstring—Helper text below (shown when no error)
errorbooleanfalseRed border error state
errorTextstring—Error message (shown instead of hint when error=true)
disabledbooleanfalseDisables all controls
classNamestring—Additional CSS classes on the wrapper
Base component → Inputswww.pepulux.com

Notes and documentation

Space for notes, documentation, and best practices for using these components.

Counters and quantities

Use the stepper for small ranges and quantities. Set min and max so the buttons disable at the limits, and allow typing for large values.