Components / Frames

Frame

The primitive everything else is built from: an enclosure plus border, rule, corner-mark and fill layers you compose yourself.

Content

Customize

Rules
Overshoot
10px
Border
Corners
Fill
Radius
0px
Line
1px

Installation

npx shadcn@latest add https://fancyborders.vercel.app/r/frame.json

The CLI copies the component into your project, adds anything it is built on, and writes its CSS into your global stylesheet. New to the CLI? See Installation.

Examples

Tailwind tokens

Colour, line width and radius are ordinary utilities, so they take variants like hover and dark.

frame-color-sky-500/50

Custom corner marks

Pass children to FrameCorners to draw your own mark. It is drawn for the top-left corner and rotated onto the others.

Diamond marks

Good to know

  • Layers are absolutely positioned and never take part in layout, so they can go inside a frame in any order, before or after the content.
  • Every layer reads its line width, colour and radius from the frame, so setting them once on the frame restyles all of them.

API reference

Frame

tsx
import { Frame } from "@/components/ui/frame";
PropTypeDefault
radiusnumber | string

Corner radius shared by the frame and its layers.

0
linenumber | string

Line width shared by borders, rules and marks.

1
colorstring

Line colour for borders, rules and fills.

22% of the text colour

Also accepts every div attribute, such as className and style.

FrameBorder

tsx
import { FrameBorder } from "@/components/ui/frame";
PropTypeDefault
variant"solid" | "dashed" | "dotted" | "double"

The CSS border style.

"solid"
offsetnumber | string

Distance from the frame's edge. Positive is outward, negative inward.

0
radiusnumber | string

Overrides the frame's radius for this layer.

–
colorstring

Overrides the frame's line colour for this layer.

–

Also accepts every div attribute, such as className and style.

FrameRules

tsx
import { FrameRules } from "@/components/ui/frame";
PropTypeDefault
sides("top" | "right" | "bottom" | "left")[]

Which sides get a line.

all four
overshootnumber | string | { x?, y? }

How far the lines run past the corners. x extends the horizontal lines, y the vertical ones.

0
dashnumber | string

Dash length. Setting dash or gap makes the lines dashed.

4
gapnumber | string

Space between dashes.

4
marchboolean | number

Make the dashes travel clockwise. A number is the seconds a dash takes to reach the next one's place; true is 0.6.

false
offsetnumber | string

Distance from the frame's edge. Positive is outward, negative inward.

0
colorstring

Overrides the frame's line colour for this layer.

–

Also accepts every div attribute, such as className and style.

FrameCorners

tsx
import { FrameCorners } from "@/components/ui/frame";
PropTypeDefault
mark"bracket" | "square" | "plus" | "dot"

Built-in mark. Ignored when children are given.

"bracket"
childrenReactNode

A custom mark, drawn for the top-left corner and repeated on the rest.

–
corners("tl" | "tr" | "br" | "bl")[]

Which corners get a mark.

all four
sizenumber | string

Width and height of each mark. The default depends on the mark: bracket, square, plus, dot.

12, 7, 11 or 5
thicknessnumber | string

Line width of the mark, when different from the frame's.

–
align"inside" | "center"

inside tucks the mark into the corner, center centres it on the frame's line. Brackets and custom marks default to inside.

–
rotateboolean

Rotate each mark to face its corner. Turn off for upright content.

true
offsetnumber | string

Distance from the frame's edge. Positive is outward, negative inward.

0
radiusnumber | string

Radius of a bracket's corner, when different from the frame's.

–
colorstring

Colour of the marks. Defaults to the text colour.

–

Also accepts every div attribute, such as className and style.

FrameFill

tsx
import { FrameFill } from "@/components/ui/frame";
PropTypeDefault
pattern"hatch" | "cross" | "dots" | "grid"

The pattern painted behind the content.

"hatch"
sizenumber | string

Spacing between lines or dots.

6
thicknessnumber | string

Line width, or dot radius.

1
anglestring

Direction of the hatch lines.

"135deg"
insetnumber | string

Distance kept clear from the frame's edge.

0
colorstring

Colour of the pattern. Defaults to the line colour.

–

Also accepts every div attribute, such as className and style.