Project Folder

A folder card for portfolios and file browsers: hovering or focusing fans out preview cards from inside, clicking grows it into a full overlay with managed focus and Escape to close, and closing plays the same path back into the folder.

Preview

Project Folder preview width

Install

Add it with the shadcn CLI, or copy the source manually.

$ bunx --bun shadcn add @karaui/project-folder
@karaui not found? Add it to components.json
{
  "registries": {
    "@karaui": "https://karaui.kamisama-v0.my.id/r/{name}.json"
  }
}

@karaui is in shadcn's public registry directory, so the latest CLI needs no setup. On an older CLI, merge this into the existing file once and every @karaui/… install resolves.

API Reference

title
string
—
description?
string
Updated recently
previews?
ProjectFolderPreview[]
[]
count?
number
previews.length
itemLabel?
string
file
open?
boolean
—
defaultOpen?
boolean
false
onOpenChange?
((open: boolean) => void)
—
expanded?
boolean
—
defaultExpanded?
boolean
false
onExpandedChange?
((expanded: boolean) => void)
—
onClick?
(() => void)
—
disabled?
boolean
false
ariaLabel?
string
—
className?
string
—

Keep in mind

Some components on this site are inspired by or recreated from existing work across the web. I'm not here to take credit; just to learn, experiment, and sometimes push things a bit further. If something looks familiar and I forgot to mention you, reach out and I'll fix that right away.

Updated