Skip to content

morvaproject/surfboard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

108 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ„ Surfboard

Version Web

Your team's shared design toolkit β€” always one keystroke away.

Ever found an incredible design tool, bookmarked it, and completely forgot it existed two weeks later? Surfboard fixes that. It's a collaborative Raycast extension that turns your team's scattered bookmarks into a shared, searchable library β€” organized by when you'd need them, not just what they're called.

"You've already found the perfect tool for this β€” you just don't remember it."


✨ What's New β€” v1.1.0 (April 2026)

Design section

Surfboard now has two sections β€” Tools and Design. Tools is everything you already know: resources, generators, libraries. Design is new β€” a dedicated space for visual references, aesthetic styles, and layout inspiration.

When saving something to Design, you'll see a new tag set built around visual directions:

  • Isometric, Brutalism, Dither, Technical
  • Standard SaaS, People First, Playful, Narrow Layout
  • Scroll Animation, Mobile App

Both the web app and Raycast extension support the new section. In Raycast, just pick the section when saving.

Web app updates (surf.morvalabs.com)

  • Section toggle β€” switch between Tools and Design with a single tap
  • Grid / List view toggle β€” switch layouts from the sidebar
  • Mobile drawer β€” section and view toggles now sit in the header row alongside the close button
  • Add to home screen on iOS now shows the Surfboard icon

Raycast updates

  • Section picker when saving or editing β€” choose Tools or Design
  • Tags update automatically based on which section you pick

Why Surfboard?

The Problem Surfboard's Fix
You bookmark a great tool but forget it exists Tag it by intent β€” search "background" and it's right there
Your teammate found the tool you need, but you don't know that Everything is shared β€” one person saves it, everyone has it
Bookmarks are flat, unsearchable, and lifeless Browse by category, search by intent, recall in 2 seconds

πŸš€ Setup (5 minutes)

Step 1 β€” Install Raycast

If you don't have it yet: raycast.com β†’ Download β†’ install like any Mac app.

Step 2 β€” Download Surfboard

Go to github.com/morvaproject/surfboard, click the green Code button β†’ Download ZIP. Unzip it anywhere (Desktop is fine).

Step 3 β€” Run the installer

Open Terminal (press Cmd + Space, type Terminal, hit Enter).

Drag the unzipped surfboard folder into the Terminal window β€” it'll fill in the path automatically. Then type /install.sh at the end so it looks like:

/Users/yourname/Desktop/surfboard/install.sh

Hit Enter. The script handles everything β€” Node.js, dependencies, build. Takes a few minutes on first run.

Step 4 β€” Add to Raycast

In Raycast: Settings β†’ Extensions β†’ + β†’ Add Local Extension β†’ select the surfboard folder.

Raycast will ask for your name the first time β€” type it so the team knows who saved what. You're in. πŸ€™


Staying updated

When there's an update, open Terminal, drag the surfboard folder in, type /install.sh and hit Enter. That's it.


🌐 Web Dashboard

Browse the full library at surfboard.morvalabs.com β€” no install needed. The web app syncs in real-time with the Raycast extension.

  • Tools β€” all your saved design resources, browseable by tag
  • Design β€” a curated section for design styles and aesthetic references (Brutalism, Isometric, Scroll Animation, and more)
  • Grid and list view, search, tag filtering β€” all in the browser

πŸ›  Commands

Command What it does
Add to Surfboard Save a new tool with tags and a note
Surfboard Search Find tools by name, description, or tag
Surfboard Browse See everything organized by category
Surfboard Import Bulk-import a list of URLs in one go

βž• Add a Tool

Raycast β†’ "Add to Surfboard"

  1. Paste the URL (favicon loads automatically)
  2. Name it
  3. Choose a section β€” Tools (resources you use) or Design (visual references and styles)
  4. Pick tags from the list β€” or type your own custom ones
  5. Add an optional note (e.g., "amazing for hero sections")

πŸ” Search

Raycast β†’ "Surfboard Search"

  • Type what you need, not what you remember
  • "background" β†’ shows everything tagged Backgrounds & Textures
  • "bento" β†’ shows every tool in the Bento category
  • "unicorn" β†’ finds Unicorn Studio by name
  • Works across names, descriptions, and tags simultaneously

🍱 Browse

Raycast β†’ "Surfboard Browse"

  • Every tool organized into sections by tag
  • See who saved what and spot tools you didn't know existed

⚑ Bulk Import

Raycast β†’ "Surfboard Import"

  • Paste multiple URLs (one per line)
  • Tag them all at once β€” great for migrating entire bookmark folders

⌨️ Keyboard Shortcuts

Shortcut Action
Enter Open tool in browser
Cmd + E Edit a tool's name, tags, or notes
Cmd + C Copy URL to clipboard
Ctrl + X Delete a tool (with confirmation)

Pro tip: Set a hotkey for Surfboard Search in Raycast Settings β†’ Extensions β†’ Surfboard β†’ Surfboard Search β†’ Hotkey (e.g., Cmd + Shift + S). One keystroke and you're searching.


🏷 Tags

Tools section tags

These are the built-in intent tags. You can also create custom tags when saving.

Tag When you need...
Backgrounds & Textures Patterns, noise, gradients, canvas textures
Icons SVG libraries, icon sets, icon generators
Fonts & Typography Font pairings, type testers, foundry sites
Color Tools Palette generators, contrast checkers, mesh gradients
Mockups & Prototyping Device mockups, 3D scenes, prototype tools
Animation & Motion Lottie, CSS animation, scroll effects, easing
Stock Photos & Video High-quality photo and video libraries
CSS & Code Tools Flexbox/Grid helpers, CSS generators, snippets
Web Inspo Landing pages, marketing sites, web galleries
Product Inspo SaaS UI patterns, dashboard references
App Inspo Mobile and desktop interaction flows
Bento & Illustrations Grid layouts, bento-style designs, illustration sets
Brand & Logos Brand guidelines, logo inspiration, identity assets

Design section tags

For visual references, aesthetic styles, and layout patterns.

Tag What it covers
Isometric Isometric illustration and 3D-style compositions
Technical Blueprint, diagram, and engineering aesthetics
Dither Pixel art, dithered textures, retro graphics
Standard SaaS Clean, functional product UI patterns
People First Human-centred, editorial illustration styles
Brutalism Raw, grid-breaking, typographic-heavy design
Scroll Animation Parallax, scroll-driven, and cinematic web experiences
Playful Rounded, colourful, expressive UI directions
Narrow Layout Column-heavy, editorial, and content-dense layouts

πŸ”„ Staying Updated

Drag the surfboard folder into Terminal, type /install.sh, hit Enter.


🧠 How It Works Under the Hood

  • Frontend: Raycast extension built with React + TypeScript
  • Backend: Supabase (hosted Postgres) β€” shared database, no setup needed for teammates
  • Sync: Real-time β€” save a tool and your teammate sees it immediately
  • Auth: None needed β€” if you have the extension, you're on the team

Built for designers who keep finding amazing tools and then forgetting they exist. Surfboard β€” because the best tools shouldn't stay buried. πŸ„β€β™‚οΈ

About

πŸ„ Surfboard β€” A shared Raycast extension for design teams. Save tools, tag them by intent, find them instantly.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors