1. Create your account
   Sign up with Google OAuth at gensand.app/login. Your account includes 5 free AI credits to get started.
2. Create your first workspace
   From the dashboard, click "New Workspace" or press Cmd+K and say "Create a workspace called My Project".
3. Add widgets
   Click the "+" button or use AI: "Add a todo list for my tasks". Drag widgets to arrange your dashboard.
4. Invite your team
   Create an organization, add team members, and start collaborating on shared workspaces.

Using the AI Assistant

The AI assistant is your primary way to interact with GenSand. Access it anytime with Cmd+K (or Ctrl+K on Windows).

Example Commands

Hierarchy

GenSand uses a three-tier hierarchy for organization:

Organization (Company level)
├── Team A (e.g., "Engineering")
│   ├── Workspace 1
│   │   └── Widgets...
│   └── Workspace 2
└── Team B (e.g., "Marketing")
    └── Workspace 3

Organizations

Organizations represent your company or business. They contain teams and provide shared settings like company name, industry, and branding.

Teams

Teams are groups of people who work together. Each team member has an expertise field (Frontend, Backend, Design, etc.) that AI uses for smart task delegation.

Workspaces

Workspaces are canvas areas where you place widgets. They can be personal or shared with a team. Think of them as visual dashboards or project boards.

Widgets

Widgets are the building blocks of your workspaces. They display information, track progress, or help you manage tasks. GenSand includes 18+ built-in widgets, and AI can create custom ones.

Tickets

Tickets are tasks or issues that need to be completed. They have:

• Title & Description - What needs to be done
• Status - TODO, IN_PROGRESS, REVIEW, DONE
• Priority - URGENT, IMPORTANT, NORMAL, LOW
• Assignees - Who's responsible
• Due Date - When it's due
• Workspace - Where it belongs

Creating Workspaces

There are several ways to create a workspace:

• Click "New Workspace" in the sidebar
• Use AI: "Create a workspace called Project Alpha"
• From a ticket's detail panel (creates a task workspace)

Workspace Types

Personal Workspaces

Only you can see and edit these. Perfect for personal dashboards, notes, and private projects.

Team Workspaces

Shared with your team. All team members can view and edit widgets based on their permissions.

Task Workspaces

Created from tickets for complex tasks. AI pre-populates them with relevant widgets like todo lists, timelines, and notes.

Sharing Workspaces

You can share workspaces publicly with a link:

• Click the share button in the workspace header
• Or use AI: "Share this workspace publicly"

Public workspaces are read-only for viewers.

Built-in Widgets

GenSand includes 18+ widget types out of the box:

Additional widgets: Habit Tracker, Mood Journal, Bookmarks, Quote Widget, Time Tracker, Day Planner, Bookshelf, Milestone Tracker.

Creating Widgets

From the Widget Palette

Click the "+" button in your workspace to open the widget palette. Select a widget type to add it.

Using AI

Simply describe what you need:

"Create a todo list called 'Sprint Tasks' with items: Design review, API integration, Write tests"

Custom Widgets

When built-in widgets don't fit your needs, AI can generate custom React components:

"Create a weather widget that shows the forecast for San Francisco"
"Build a stock ticker widget for AAPL, GOOGL, and MSFT"
"Create a countdown widget for New Year's Eve"

Creating Tickets

Create tickets through:

• The Tickets page - click "New Ticket"
• AI command: "Create a ticket for building the login page"
• Upload a document: "Create tickets from this requirements doc"

Ticket Properties

AI-Powered Features

Smart Assignment

When you create a ticket, AI analyzes the description and suggests the best assignee based on:

• Team member expertise (Frontend, Backend, Design, etc.)
• Current workload
• Past performance

Priority Detection

AI detects priority from keywords:

• urgent, asap, critical → URGENT
• important, priority, soon → IMPORTANT
• when possible → NORMAL
• low priority, nice to have → LOW

Bulk Creation

Upload meeting notes or requirements documents, and AI will extract and create multiple tickets automatically.

Creating an Organization

Organizations are created automatically during onboarding for business accounts. You can also create them manually:

• Go to Settings → Organizations
• Or use AI: "Create an organization called Acme Corp"

Organization Settings

Configure your organization with:

• Company name
• Industry
• Company size
• Mission statement
• Products/services
• Tech stack

This context helps AI make better suggestions for task delegation and workflow creation.

Teams

Teams are groups within an organization. Each team has:

• Name and description
• Members with roles
• Shared workspaces

Member Expertise

Each team member has an expertise field that AI uses for smart delegation. Available roles include:

• Engineering: Frontend, Backend, Fullstack, DevOps, QA, etc.
• Product: Product Manager, Product Designer, UX Researcher
• Design: UI Designer, Graphic Designer, Brand Designer
• Marketing: Growth, Content, SEO, Social Media
• Sales: Account Executive, SDR, Sales Manager
• Operations: Project Manager, Scrum Master, Operations Manager

Inviting Members

Invite team members by email:

• Go to the team page and click "Invite Member"
• Or use AI: "Invite john@example.com to the Engineering team"

What are Workflows?

Workflows are predefined sequences of stages, each containing tickets. When tickets in one stage complete, the next stage automatically unlocks.

Creating Workflows

Use AI to create workflows from templates:

"Create a product launch workflow with design, development, testing, and release phases"

Available Templates

How Dependencies Work

Tickets in later stages are automatically blocked until earlier stages complete. When you mark a blocking ticket as DONE, dependent tickets become unblocked.

Finding Widgets

Browse the marketplace to find widgets created by other users:

• Go to the Marketplace page
• Search by name or category
• Or use AI: "Find a water tracker widget"

Adding to Collection

When you find a widget you like, add it to your collection. You can then use it in any of your workspaces.

Publishing Widgets

Share your custom widgets with the community:

1. Create a widget in your workspace
2. Click the publish button or use AI: "Publish this widget to marketplace"
3. Add a description and category

Accessing the AI

There are three ways to access the AI assistant:

• Cmd+K (or Ctrl+K) - Opens from anywhere
• Dashboard input field - Type directly on your dashboard
• Sparkles button - Click the AI button at the bottom of the screen

What AI Can Do

AI Credits

Each AI interaction uses credits based on the action:

Credit Limits by Plan

Widget Commands

Ticket Commands

Navigation Commands

Query Commands

Built-in vs Custom

When you ask AI to create a widget, it first checks if a built-in widget matches your request. If not, it generates a custom React component.

Built-in Widgets (1 credit)

"Create a todo list for sprint tasks"  → Uses built-in todo-list
"Add a pomodoro timer"                  → Uses built-in pomodoro
"Create a kanban board for the project" → Uses built-in kanban

Custom Widgets (3 credits)

"Create a weather widget for San Francisco"  → Generates custom React code
"Build a stock ticker for AAPL"               → Generates custom React code
"Create a countdown to New Year's Eve"        → Generates custom React code

Custom Widget Capabilities

AI-generated widgets can:

• Fetch data from external APIs
• Display interactive visualizations
• Store and update local state
• Respond to user interactions

How It Works

When you create a ticket, AI analyzes the description and considers:

1. Keywords - Technical terms that indicate the type of work
2. Expertise Match - Team members whose roles align with the task
3. Workload - Current assignments and capacity
4. Context - Company priorities and project history

Keyword Mapping

Using Delegation Features

"Who should work on the API integration?"
"Show team availability"
"What's blocked?"
"Recommend someone for the design review"

Plans

Managing Your Subscription

Go to the Billing page to:

• View your current plan and usage
• Upgrade or downgrade your plan
• Update payment method
• View invoice history
• Cancel subscription

Annual Billing

Save with annual billing:

• Pro: $99/year (save $20.88)
• Business: $499/year (save $100.88)

Profile Settings

• Name - Your display name
• Email - Your account email (read-only if using OAuth)
• Avatar - Profile picture from Google or uploaded

Organization Settings

If you own an organization, you can configure:

• Company name and industry
• Company size
• Mission and description
• Products/services
• Tech stack
• Current priorities

Appearance

GenSand automatically follows your system preference for light/dark mode.

Authentication

GenSand uses industry-standard authentication:

• Google OAuth 2.0 - Secure sign-in without storing passwords
• Session Management - Encrypted session tokens
• HTTPS - All traffic is encrypted

Data Protection

• Data encrypted at rest and in transit
• Regular security audits
• SOC 2 compliant infrastructure (via cloud providers)

Shared Workspaces

When you share a workspace publicly:

• Viewers can only see widget content
• They cannot edit, add, or delete widgets
• Your personal data is not exposed
• You can revoke access anytime

Global Shortcuts

Workspace Shortcuts

What happens when I run out of AI credits?

Free users get 5 one-time credits. Once used, you'll need to upgrade to Pro or Business for more. Pro users get 100 credits that reset monthly, Business users get 400.

Can I export my data?

Yes, you can export workspace data through shared workspace links or by contacting support for a full data export.

Is there a mobile app?

GenSand is a web application optimized for both desktop and mobile browsers. A native mobile app is on our roadmap.

Can I use GenSand offline?

GenSand requires an internet connection to sync data and use AI features. Offline mode is planned for a future release.

How do I delete my account?

Go to Settings and scroll to the bottom to find the "Delete Account" option. This will permanently delete all your data.

Can I transfer ownership of an organization?

Contact support to transfer organization ownership to another user.

Getting Help

Response Times