WorkRunner Documentation

Constructs

Everything you need to know about building production-ready Constructs.

What is a Construct?

A Construct is a self-contained React micro-app that runs on the Work platform. Think of it like a song on Spotify - users stream Constructs to solve business problems, and Runners earn from every stream.

Constructs ARE

  • • Single-file React components
  • • Self-contained with localStorage
  • • Styled with Tailwind CSS
  • • Built with shadcn/ui components
  • • Accessible and responsive

Constructs are NOT

  • • Multi-page applications
  • • Connected to external APIs
  • • Using custom CSS or styled-components
  • • Dependent on external packages
  • • Complex backend-dependent apps

Core Requirements

RequirementDetailsWhy
Single FileOne App.tsx with default exportSandbox isolation
shadcn/ui OnlyUse approved componentsConsistent UX
Tailwind CSSUtility classes onlyNo CSS conflicts
localStoragework-construct- prefixData persistence
Lucide Iconslucide-react onlyBundle size
No API CallsNo fetch, axios, etc.Security sandbox
AccessibleWCAG AA complianceInclusive design
ResponsiveMobile-first designCross-device support

Construct Ideas

Looking for inspiration? Here are some high-demand Constructs:

Expense Tracker
Invoice Generator
Meeting Notes
Time Logger
Inventory Counter
Contact Directory
Project Kanban
Goal Tracker
Habit Tracker
Pomodoro Timer
Password Generator
Unit Converter