Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

responsive

/responsive

Wymusza responsywny interfejs Esposter: jeden komponent dla każdego urządzenia, bez wariantów dedykowanych urządzeniom, przy dodawaniu lub edycji pasków narzędzi, wierszy akcji i grup przycisków.

Repozytorium
Esposter ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Wymusza responsywny interfejs Esposter: jeden komponent dla każdego urządzenia, bez wariantów dedykowanych urządzeniom, przy dodawaniu lub edycji pasków narzędzi, wierszy akcji i grup przycisków.

Oryginalny opis (EN)

Apply when adding or editing any toolbar, action row, button group or surface that must work on mobile, or when tempted to write a device-specific component or folder. Esposter responsive UI — one component for every device, never a device-specific variant.

Jak działa

  1. Settled — do not re-propose
  2. One component for every device
  3. Occasional commands wait in the overflow menu
  4. flex-wrap is the rare exception
  5. Reference pages
Sekcje z nagłówków SKILL.md, w oryginale · 80 linii, 744 słów
Podgląd SKILL.md
---
name: responsive
description: Apply when adding or editing any toolbar, action row, button group or surface that must work on mobile, or when tempted to write a device-specific component or folder. Esposter responsive UI — one component for every device, never a device-specific variant.
---

# Responsive / Mobile UI

Narrow viewports are a first-class target, not an afterthought. A row of buttons that fits on a desktop toolbar does not fit on a phone — it either overflows horizontally or wraps into a tall stack of full-width buttons that pushes the actual content off-screen.

## Settled — do not re-propose

- **A device-specific component, folder or name** (`mobile/`, a `Mobile` prefix, a phone-only bar of buttons) — every fix to a surface lands in two copies that drift; write one component and climb the ladder (`One component for every device`, this file).
- **A sheet on a phone in place of a popover** — the popover stays anchored at every width and sizes itself with `min()` against the viewport (`One component for every device`, this file).

## One component for every device

Each surface is written once for every width and climbs the promotion ladder — reflow, a breakpoint prefix, the overflow menu, a container the library swaps, a component per input device — only as far as the rung below fails; there is no `mobile/` folder, no `Mobile` prefix and no phone-only bar of buttons (`openspec/specs/architecture/responsive/design.md`, "One component for every device"). A popover stays anchored at every width, sized with `min()` against the viewport, never a sheet on a phone. What the reader holds — a touch screen's keyboard, a joystick — is `isTouchScreen` or device detection, never a breakpoint.

A region shown from a breakpoint takes the `hidden` **class** (`class="hidden md:flex"`), since the reset hides the attribute form with a rule no breakpoint's display can outrank. `apps/web/app/templates.test.ts` ("breakpoints") refuses the attribute form.

## Occasional commands wait in the overflow menu

A surface shows its toggles, its one lead action and its close mark, and keeps every occasional command in a `UiOverflowMenu` **on every width** — nothing swaps at a breakpoint, so there is no second presentation of the same commands to drift from the first. The menu takes an `Item[]`, and every item carries a mark (`meaning`, or a whole `icon` class) beside its `title`: a menu is a list of labelled rows, never a grid of naked icons. The resource list's toolbar (`apps/web/app/components/Resource/List/Toolbar.vue`):

```vue
<script setup lang="ts">
// The two views of the list are toggles that say whether they are on, so they stay out on every width; what is done
// Now and then waits in the overflow menu
const items = computed<Item[]>(() => [
  { meaning: UiIconMeaning.Download, onClick: () => emit("export"), title: "Export CSV" },
  { meaning: UiIconMeaning.Refresh, onClick: () => emit("refresh"), title: "Refresh" },
  {
    isGroupStart: true,
    meaning: UiIconMeaning.Delete,
    onClick: async () => {
      await navigateTo(RoutePath.ResourceExplorerRecycleBin);
    },
    title: "Recycle bin",
  },
]);
</script>

<template>
  <UiIconButton
    :aria-pressed="isSummaryView"
    label="Summary view"
    :meaning="UiIconMeaning.Summary"
    :variant="UiButtonVariant.Quiet"
    @click="isSummaryView = !isSummaryView"
  />
  <UiIconButton
    :aria-pressed="isGroupedByType"
    label="Group by type"
    :meaning="UiIconMeaning.Group"
    :variant="UiButtonVariant.Quiet"
    @click="isGroupedByType = !isGroupedByType"
  />
  <ResourceListColumnChooserMenu :source />
  <UiOverflowMenu :items label="List actions" />
  <ResourceCloseButton />
</template>
```

### What stays out of the menu

- **Close / dismiss (`✕`)** — the escape hatch must never be buried inside a menu.
- **A control that is already its own dropdown** (the column chooser in the toolbar example under "Occasional commands wait in the overflow menu" on this page). It is already one tap to a list; nesting a menu inside a menu is worse than leaving it out. Leave it beside the `…`.
- **The primary action of the screen**, when the screen has exactly one.
- **A toggle**, which says whether it is on — a state a menu row hides until it is opened.

### Dialogs live outside the menu

A dialog a menu item opens is mounted in the toolbar, never inside the menu, which destroys it on close (`references/dialogs-from-menus.md`).

## `flex-wrap` is the rare exception

Wrapping a button row to a second line is allowed **only** when the surface genuinely has vertical room to spare and the row is short (roughly ≤ 3 controls) — e.g. a transient selection toolbar. It is not the default, and it is never the answer for a full command bar. When in doubt, move the occasional commands into the `…`.

**A bar that pushes its groups apart never wraps.** A group pushed to the row's end strands alone on a second line once the row runs short. The leading content yields instead (`truncate`, `min-w-0`) and the occasional actions wait in the overflow menu. `apps/web/app/templates.test.ts` ("bars") refuses the wrapping combination.

## Reference pages

- `references/dialogs-from-menus.md` — when a menu item opens a dialog.
Pliki w paczce (2)
  • SKILL.md 5 KB
  • references/dialogs-from-menus.md 1 KB

Wersje

W bazie nie ma innych skilli o nazwie responsive.

Migawka bazy z 13.11.2026 · wersja paczki f1f34685fffd (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90vue-component-patterns
    Opisuje, jak w projekcie Esposter pisać, typować i nazywać pojedynczy komponent Vue 3 przy tworzeniu lub refaktoryzacji.
  • 100bench
    Prowadzi przy dodawaniu i edycji benchmarków, mierzeniu czasu działania i kosztu typów dla kompilatora oraz zmianach w plikach bench.md i typebench.md w projekcie Esposter.
  • 90frontend-ui-engineering
    Buduje i dopracowuje interfejs webowy: struktura komponentów, responsywny układ, tokeny projektowe, stan i dostępność, w pracach nad UI funkcji wykraczających poza same kontrole WCAG.
  • 100esp32-i2c-device-discovery
    Wykrywa urządzenia na magistrali I2C ESP32 i sprawdza, czy każdy adres odpowiada oczekiwanemu czujnikowi.
  • 86ui-change
    Wprowadza małe zmiany interfejsu: okno modalne, przycisk, układ responsywny i style komponentów w Tailwind lub CSS.
  • 100responsive-patterns
    Opisuje responsywny design w React: container queries, płynną typografię, jednostki cqi i cqb, subgrid, układy intrinsic, urządzenia składane i wzorce mobile-first.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.