Workspace onboarding

Guide a team from creating a workspace to completing its first shared task.

Customize the recipe

0/1500 characters
Workflow boosters

Prompt preview

# Workspace onboarding

Guide a team from creating a workspace to completing its first shared task.

## Deliverable
A runnable onboarding flow with resume behavior and seeded invited and owner roles.

## Stack and visual direction
- Recommended starting stack: Next.js and TypeScript with scoped server-side data access. Start with an explicit persistence and permissions model.
- Minimalism: Use deliberate spacing, a compact palette and a clear typographic hierarchy. Retain the labels, feedback and affordances people need to act. Apply this direction to the interface while keeping data and controls easy to read.

- Inspect the workspace first. Adapt to its stack when it contains a project, or use the recommended starting stack in a new workspace.

## Tools and setup · Universal
Use the receiving agent’s documented skill and tool mechanisms. Match setup to the agent and workspace you actually have.

Check available tools first. Propose documented project-level setup only when it materially helps and follow the host's permission prompts. If a tool or integration is unavailable, continue with the workflow below using existing tools, local fixtures or a manual check. Keep secrets in the intended configuration environment.

- [shadcn/ui Skill](https://ui.shadcn.com/docs/skills) (Skill) — Inspect the project's component registry and assemble accessible UI primitives.
  Project with compatible React and styling configuration. Follow the skill's agent-specific setup. Fallback: Reuse established controls in the project, or start with semantic native controls and test keyboard and error states.
- [Supabase](https://github.com/supabase/supabase) (Repository) — Consider PostgreSQL persistence, authentication and row-level permissions for shared applications.
  Use a local stack or configure an authorized project for integration checks.
- [React Hook Form](https://github.com/react-hook-form/react-hook-form) (Repository) — Implement labeled forms with validation, accessible errors and preserved inputs.

## Workflow
1. Model workspace creation, member roles, and user progress. Sequence a small required setup, mark optional invites clearly, and persist completed steps.
2. Use the simplest implementation that delivers the stated outcome. Follow the user's project constraints and treat the starting stack as a default. Reuse existing work and ask for essential input only when it would change the result. Use realistic labeled sample data when real inputs are unavailable.
3. Run the applicable checks and report what actually passed along with any checks you could not run.

## Acceptance checks
- [ ] Returning after partial setup resumes at the correct step.
- [ ] A member cannot edit workspace-level setup reserved for the owner.
- [ ] Walk the primary journey with keyboard only. Check visible focus, logical order, accessible names, readable contrast, zoom and reduced motion. Use axe where available and manually check behavior that automation cannot assess.
- [ ] Verify real actions and persisted data where required. Exercise relevant loading, empty, invalid, pending, failure and success states. Provide a clear recovery path.
- [ ] Use fixtures to verify core flows, including a narrow-screen layout and any applicable permission boundaries.

Recipe resources

Source, setup, and compatibility details.