Kwark. Design System
Open Kwark

Floating action button

One labelled action floating at the foot of a phone screen, for a surface that has no floating dial. It names where the new thing will land.

ComponentsActionsReady for Kwark
ShotsScene 12
12A · WideMira at the bench · 35mm
12B · InsertThe splice, hands · 50mm
ShotsScene 12 · 2 shots
ShotsScene 12 · 9 shots
<div class="kw-phone-frame">
  <div class="kw-phone-frame__body">
    <div class="kw-phone-frame__head">Shots<small>Scene 12 · 2 shots</small></div>
    <div class="kw-lrow-list" style="max-width:none;border-top:0">
      <div class="kw-lrow"><button class="kw-lrow__main" type="button"><span class="kw-lrow__text"><span class="kw-lrow__title">12A · Wide</span><span class="kw-lrow__meta">Mira at the bench · 35mm · 0:08</span></span></button></div>
      <div class="kw-lrow"><button class="kw-lrow__main" type="button"><span class="kw-lrow__text"><span class="kw-lrow__title">12B · Insert</span><span class="kw-lrow__meta">The splice, her hands · 50mm · 0:03</span></span></button></div>
    </div>
  </div>
  <button class="kw-efab" type="button" aria-label="Add shot 12C to Scene 12"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 5v14M5 12h14"/></svg><span class="kw-efab__label">Add shot</span><span class="kw-efab__num">12C</span></button>
</div>
<div class="kw-phone-frame kw-phone-frame--short">
  <div class="kw-phone-frame__body">
    <div class="kw-phone-frame__head">Shots<small>Scene 12 · 9 shots</small></div>
    <div class="kw-lrow-list" style="max-width:none;border-top:0">
      <div class="kw-lrow"><button class="kw-lrow__main" type="button"><span class="kw-lrow__text"><span class="kw-lrow__title">12G · Close</span><span class="kw-lrow__meta">Aanya in the doorway · 85mm</span></span></button></div>
      <div class="kw-lrow"><button class="kw-lrow__main" type="button"><span class="kw-lrow__text"><span class="kw-lrow__title">12H · Over the shoulder</span><span class="kw-lrow__meta">Mira, the monitor · 50mm</span></span></button></div>
    </div>
  </div>
  <button class="kw-efab kw-efab--compact" type="button" aria-label="Add shot 12J to Scene 12"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 5v14M5 12h14"/></svg><span class="kw-efab__label">Add shot</span><span class="kw-efab__num">12J</span></button>
</div>

What it is

A 48px pill that floats 16px from the bottom-right of a phone screen and does one thing: make the next item of what the screen lists. It exists for surfaces that do not show the floating dial, such as a standalone shot list opened from a link, or a tool built on the Kwark system outside the app.

The one-floating-control rule

Kwark phone screens have exactly one floating control (Decision 0011, Decision 0016). Where the dial is present, the dial is the floating control and Add shot goes into the page content or the Menu sheet. A floating action button never sits beside the dial.

The Kwark idea: it says where the new thing lands

A generic FAB is a plus. Kwark’s names the item it will create, with the number it will take: Add shot 12C under Scene 12, Add scene 47A on a locked script, Add day 25 in the schedule. People can see before they press that the shot goes into Scene 12, not wherever they were last week. Scrolling down shrinks it to the plus and the number (+ 12C); scrolling up brings the word back.

When to use

  • One creation action that is the main reason for the screen, on a phone, where the screen has no dial.

When not to use

  • On desktop: use a button in the module head.
  • For navigation, saving, or anything destructive.
  • When the screen already has the dial, a sheet open, or the keyboard up (it tucks away while typing).

Room for it

The page keeps --k-fab-slot (78px plus the safe area) free at its foot, so the last row is never under the button.

Anatomy

  1. Pill: 48px tall, 14px left and 16px right padding, --k-radius-pill, --k-accent with --k-on-accent text, --k-shadow-pop (it floats).
  2. Glyph: a 20px plus at stroke 2.
  3. Label: verb and object, Poppins 500 14px: Add shot.
  4. Number tag: 22px pill, 20% --k-on-accent wash, Poppins 600 12px tabular: 12C.
  5. Compact: the label is hidden visually (it stays in the accessible name); glyph and number remain, 12px padding.
  6. Position: 16px from the right and bottom, inside the safe area; the page reserves --k-fab-slot.
  7. States: hover brightens 10%, pressed 92%, focus a 2px --k-focus ring 3px out, busy shows the spinner in place of the plus.

Tokens

Token Light Dark
--k-accent #98633f #98633f
--k-on-accent #ffffff #ffffff
--k-shadow-pop 0 1px 2px rgba(15, 23, 42, .06), 0 12px 32px rgba(15, 23, 42, .12) 0 2px 6px rgba(0, 0, 0, .2), 0 16px 36px rgba(0, 0, 0, .55)
--k-radius-pill 999px
--k-fab-slot calc(78px + env(safe-area-inset-bottom))
--k-tap 44px
--k-fs-body 14px
--k-fs-meta 12px
--k-focus #0f172a #f4f4f5
--k-icon-lg 20px

React

Use the HTML below with kwark.css. The example shows the markup and styling. Supply any application behavior described on this page.

HTML and CSS

Works anywhere with kwark.css.

<div class="kw-phone-frame">
  <div class="kw-phone-frame__body">
    <div class="kw-phone-frame__head">Shots<small>Scene 12 · 2 shots</small></div>
    <div class="kw-lrow-list" style="max-width:none;border-top:0">
      <div class="kw-lrow"><button class="kw-lrow__main" type="button"><span class="kw-lrow__text"><span class="kw-lrow__title">12A · Wide</span><span class="kw-lrow__meta">Mira at the bench · 35mm · 0:08</span></span></button></div>
      <div class="kw-lrow"><button class="kw-lrow__main" type="button"><span class="kw-lrow__text"><span class="kw-lrow__title">12B · Insert</span><span class="kw-lrow__meta">The splice, her hands · 50mm · 0:03</span></span></button></div>
    </div>
  </div>
  <button class="kw-efab" type="button" aria-label="Add shot 12C to Scene 12"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 5v14M5 12h14"/></svg><span class="kw-efab__label">Add shot</span><span class="kw-efab__num">12C</span></button>
</div>
<div class="kw-phone-frame kw-phone-frame--short">
  <div class="kw-phone-frame__body">
    <div class="kw-phone-frame__head">Shots<small>Scene 12 · 9 shots</small></div>
    <div class="kw-lrow-list" style="max-width:none;border-top:0">
      <div class="kw-lrow"><button class="kw-lrow__main" type="button"><span class="kw-lrow__text"><span class="kw-lrow__title">12G · Close</span><span class="kw-lrow__meta">Aanya in the doorway · 85mm</span></span></button></div>
      <div class="kw-lrow"><button class="kw-lrow__main" type="button"><span class="kw-lrow__text"><span class="kw-lrow__title">12H · Over the shoulder</span><span class="kw-lrow__meta">Mira, the monitor · 50mm</span></span></button></div>
    </div>
  </div>
  <button class="kw-efab kw-efab--compact" type="button" aria-label="Add shot 12J to Scene 12"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 5v14M5 12h14"/></svg><span class="kw-efab__label">Add shot</span><span class="kw-efab__num">12J</span></button>
</div>

Keyboard

Key Does
Tab Reaches it after the page content, before the footer. It is last in reading order, as it is last visually.
Enter / Space Creates the item and moves focus to its first field.

ARIA and announcements

  • A real <button> whose accessible name says all of it: Add shot 12C to Scene 12. The compact form keeps the same name.
  • After creation, announce Shot 12C added in a polite live region, then focus the new shot’s description.
  • People with Read access do not see it at all; a disabled FAB floats over the work and says nothing useful (Decision 0042).

Touch

48px, at least 16px from every edge, and it never covers the last row thanks to --k-fab-slot.

Rules

  • Never show a floating action button on a screen that has the floating dial; one floating control per phone screen.
  • Must name the item and the number it will create (“Add shot 12C”), and keep the full name in the accessible name when compact.
  • Must reserve --k-fab-slot at the foot of the page so the last row is never covered.
  • Never use it for saving, navigation, sharing or anything destructive.
  • Always hide it, rather than disable it, for people who cannot create there.

AI readiness test

Task. Add a phone shortcut for adding a shooting day to the schedule.

Give the agent. This page, Floating dial, Phones pattern, Decision 0016.

Constraint. The schedule screen inside the app shows the floating dial.

A reliable answer

  • Does not add a second floating control
  • Puts “Add day 25” in page content or the dial’s sheet
  • If used outside the app, the FAB reads “Add day 25” and reserves --k-fab-slot

Give this Markdown to your coding agent or share its URL.

Open .mdllms.txt
Loading…