<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
- Pill: 48px tall, 14px left and 16px right padding,
--k-radius-pill,--k-accentwith--k-on-accenttext,--k-shadow-pop(it floats). - Glyph: a 20px plus at stroke 2.
- Label: verb and object, Poppins 500 14px: Add shot.
- Number tag: 22px pill, 20%
--k-on-accentwash, Poppins 600 12px tabular: 12C. - Compact: the label is hidden visually (it stays in the accessible name); glyph and number remain, 12px padding.
- Position: 16px from the right and bottom, inside the safe area; the page reserves
--k-fab-slot. - States: hover brightens 10%, pressed 92%, focus a 2px
--k-focusring 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