shadcn.io is an independent project built on shadcn/ui
On this page5 sections
Installation
Overview
Plan a place together, with this notes board map for Vue with Ark UI. Huddlemap, a shared notes map, holds a film crew's scouting notes for an Edinburgh shoot: nine notes from Dean Village to Salisbury Crags, each pinned at its real place on a live Map that follows your theme. Every person is a shape with their initials (Maya a circle, Theo a square, Inês a diamond, Sam a pill), the same on the map, in the list and in the filter, so who wrote a note never rests on colour. Click the map to drop a note by whoever is posting, chosen from the marks in the Toggle Group floating over the map, or press Add at centre to drop one where the map is aimed; its popup opens with the cursor in a Textarea, takes up to 140 characters and names the nearest place, and a note left empty is dropped when it closes. Open any note, from its mark or its row, to edit it or delete it. Four Checkbox rows above the list show or hide each person's notes with their counts: hidden notes shrink to hollow dots on the map and leave the list, and an Empty state says when nothing is shown. Built from Map, Toggle Group, Textarea, Checkbox, Button, Empty and Guides. For trip planning, site visits, event layouts and any team that works on a map.
FAQ
How do I add a note?
Click the map: a note by the person picked under Posting as lands there, and its editor opens with the cursor in it. A click while a note is open only closes it, so a stray click never adds one. Add at centre drops a note where the map is aimed, which is how the keyboard adds one: pan with the arrow keys, then press it. The board holds 24 notes in this demo.
How does a new note get its place?
placeWords measures the great-circle distance from the note to every named place in the block (the notes' own and a short gazetteer of the Old Town and the New Town) and names the closest one within 450 metres, for instance near the Scott Monument. Farther out, the note shows its latitude and longitude instead. Nothing is looked up online.
Why shapes and initials instead of colours?
A colour per person fails for people who can't tell the hues apart and changes meaning with every theme. A shape and two letters read the same in light and dark, in any preset and in print. Their names are in the caption, the filter, every row and every note's label for screen readers.
Can I use it without a mouse?
Yes. Every note is a row in the list: pressing one flies the map there, opens its editor and puts the cursor in it. On the map each mark is a button that opens its note with Enter, and Escape closes it and hands focus back. Delete moves focus to the list's heading. The filter rows are checkboxes, the poster a toggle group, and a polite message says what changed.
Is anything saved or shared?
No. The notes live in the block's state: a reload brings back the nine sample notes, and nothing is sent anywhere. The only requests are the map's tiles, from CARTO's free basemaps over OpenStreetMap data. Keep notes in your own store and pass them in to make the board shared. The places are real; Huddlemap, the crew and the notes are invented.
How does it look on a phone?
The map comes first, with the posting bar over it (Add at centre keeps only its icon), then the four people to tick, one a row, and the list in its own scroll. Opening one note frames it a zoom level further out than on a wide screen, so its popup has room. Scrolling the page over the map scrolls the page: use two fingers to pan it.





