Skip to content
Skills Library
Programming · Building & coding

Format numbers

/Format numbers

Format numbers using the formatNumber function from Shade whenever someone edits a TSX file.

Repository
Ghost ↗
Licence
MIT
Last repository change
25.10.2026

Assessment and security

90/ 100Class: good
Format15 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Format numbers using the formatNumber function from Shade whenever someone edits a TSX file.

Original author description

Format numbers using the formatNumber function from Shade whenever someone edits a TSX file.

How it works

  1. Import
  2. When to use formatNumber
  3. Correct usage
  4. Antipatterns to avoid
  5. Related utilities
Original SKILL.md headings · 56 lines, 184 words
SKILL.md preview
---
name: Format numbers
description: Format numbers using the formatNumber function from Shade whenever someone edits a TSX file.
autoTrigger:
  - fileEdit: "**/*.tsx"
---

# Format Numbers

When editing `.tsx` files, ensure all user-facing numbers are formatted using the `formatNumber` utility from `@tryghost/shade/utils`.

## Import

```typescript
import { formatNumber } from '@tryghost/shade/utils';
```

## When to use formatNumber

Use `formatNumber()` when rendering any numeric value that is displayed to the user, including:

- Member counts, visitor counts, subscriber counts
- Email engagement metrics (opens, clicks, bounces)
- Revenue amounts (combine with `centsToDollars()` for monetary values)
- Post analytics (views, link clicks)
- Any count or quantity shown in UI

## Correct usage

```tsx
<span>{formatNumber(totalMembers)}</span>
<span>{formatNumber(link.count || 0)}</span>
<span>{`${currencySymbol}${formatNumber(centsToDollars(mrr))}`}</span>
<span>{post.members > 0 ? `+${formatNumber(post.members)}` : '0'}</span>
```

## Antipatterns to avoid

Do NOT use any of these patterns for formatting numbers in TSX files:

```tsx
// BAD: raw .toLocaleString()
<span>{count.toLocaleString()}</span>

// BAD: manual Intl.NumberFormat
<span>{new Intl.NumberFormat('en-US').format(count)}</span>

// BAD: raw number without formatting
<span>{memberCount}</span>

// BAD: manual regex formatting
<span>{count.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',')}</span>
```

## Related utilities

- `formatPercentage()` - for percentages (e.g., open rates, click rates)
- `abbreviateNumber()` - for compact notation (e.g., 1.2M, 50k)
- `centsToDollars()` - convert cents to dollars before passing to `formatNumber`

All are imported from `@tryghost/shade/utils`.

Versions

The database has no other skills named Format numbers.

Database snapshot: 13.11.2026 · package version 84ab953ad7c0 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 85Shade imports
    Import Shade from layer-specific subpaths (primitives, components, patterns, page-templates, utils), never the root barrel. Trigger when editing TSX/TS in Shade-consuming apps.
  • 90Shade no dark variants
    Don't write dark: Tailwind variants for colour in Shade or admin apps — semantic tokens flip in dark mode automatically. Trigger when editing TSX in Shade-consuming apps.
  • 87typescript-best-practices
    TypeScript best practices. Use when reading or editing any .ts or .tsx file.
  • 87typescript-best-practices
    TypeScript best practices. Use when reading or editing any .ts or .tsx file.
  • 87typescript-best-practices
    TypeScript best practices. Use when reading or editing any .ts or .tsx file.
  • 87typescript-best-practices
    TypeScript best practices. Use when reading or editing any .ts or .tsx file.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.