Skip to content

ChronicStone/nuxt-ui-tools / skills/consumer/query-state

nuxt-ui-tools-query-state

Verified

Use this skill when building or debugging URL-backed state with nuxt-ui-tools as a package consumer. Covers codecs, useQueryState, useQueryStates, dynamicQueryState, grouped state, dynamic keys, and practical query-string examples.

references/patterns.md

View on GitHub
# Query State Patterns

## Good: One Value

```ts
const locale = useQueryState({
  key: 'locale',
  codec: stringCodec,
  defaultValue: 'en',
})
```

## Good: Grouped Values

```ts
const pagination = useQueryStates({
  prefix: 'p',
  schema: {
    pageIndex: { urlKey: 'page', codec: numberCodec, defaultValue: 1 },
    pageSize: { urlKey: 'size', codec: numberCodec, defaultValue: 20 },
  },
})
```

## Good: Dynamic Values

Use `dynamicQueryState(...)` when the URL keys come from runtime definitions, such as user-configured filter definitions.

## Good: Keep Related Keys Grouped

```ts
const sorting = useQueryStates({
  prefix: 's',
  schema: {
    key: { codec: stringCodec, defaultValue: '' },
    dir: { codec: createEnumCodec(['asc', 'desc']), defaultValue: 'asc' },
  },
})
```

This yields a URL shape like:

```txt
?s.key=hiredAt&s.dir=desc
```

Grouping related keys keeps the API easier to read and keeps URL ownership obvious.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall