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/overview.md

View on GitHub
# Query State Overview

This package gives you typed URL/query-param state.

Current main APIs:

- `useQueryState(...)`
- `useQueryStates(...)`
- `dynamicQueryState(...)`
- codecs like `stringCodec`, `numberCodec`, `createEnumCodec(...)`

## What Each One Is For

- `useQueryState(...)`
  one URL-backed value
- `useQueryStates(...)`
  a grouped set of URL-backed values
- `dynamicQueryState(...)`
  definition-driven keys where the key set is not static

## Quick Example

```ts
const layout = useQueryState({
  key: 'layout',
  codec: createEnumCodec(['grid', 'table']),
  defaultValue: 'table',
})
```

If `layout.value = 'grid'`, the URL becomes:

```txt
?layout=grid
```
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