# Number Format (/forms/number-format)





<ComponentPreview name="number-format-preskok-demo" description="Number formatting utilities and component." />

## Installation [#installation]

<CodeTabs>
  <TabsList>
    <TabsTrigger id="cli">
      CLI
    </TabsTrigger>

    <TabsTrigger id="manual">
      Manual
    </TabsTrigger>
  </TabsList>

  <TabsContent id="cli">
    ```bash
    npx shadcn@latest add @preskok/number-format
    ```
  </TabsContent>

  <TabsContent id="manual">
    <Steps>
      <Step>
        Copy and paste the following files into your project.

        <ComponentSource name="number-format" title="registry/preskok/ui/preskok-ui/number-format/number-format.tsx" />

        <ComponentSource name="number-format" title="registry/preskok/ui/preskok-ui/number-format/number-format-context.tsx" />

        <ComponentSource name="number-format" title="registry/preskok/ui/preskok-ui/number-format/number-format-helpers.ts" />

        <ComponentSource name="number-format" title="registry/preskok/ui/preskok-ui/number-format/currency-helpers.ts" />
      </Step>

      <Step>
        Update the import paths to match your project setup.
      </Step>
    </Steps>
  </TabsContent>
</CodeTabs>

## Usage [#usage]

```tsx
import {
  NumberFormatProvider,
  NumberText,
  useNumberFormat,
} from "@/components/ui/preskok-ui/number-format/number-format"

export function NumberFormatDemo() {
  return (
    <NumberFormatProvider locale="en-US" currency="USD">
      <NumberText value={12345.67} />
    </NumberFormatProvider>
  )
}
```