Skip to main content

​
Improver Guide

Improvers execute workflow steps and earn SFLuv tokens for completing community projects. This guide covers claiming steps, submitting evidence, managing absence periods, and requesting credentials.

​
Getting Started

​
Requesting Improver Access

1

Navigate to Settings

Go to /settings and request improver status if you’re not already approved.
2

Wait for Admin Approval

An admin will review and approve your improver access request.
3

Access the Improver Panel

Once approved, navigate to /improver to see available workflows.

​
Understanding Credentials

Workflow steps require specific credentials (e.g., dpw_certified, sfluv_verifier). You can only claim steps for roles that match your active credentials.

​
Requesting Credentials

1

Go to Credentials Tab

In the improver panel, navigate to the “Credentials” tab.
2

View Your Active Credentials

See which credentials you currently hold.
3

Request New Credentials

  • Select a credential type from the dropdown
  • Click “Request Credential”
  • An issuer will review your request
4

Track Request Status

View pending, approved, and rejected requests in the Credentials tab.
Focus on earning credentials that match high-demand workflow roles in your area.

​
Claiming Workflow Steps

​
Finding Available Workflows

The “Workflow Board” tab shows all workflows with claimable steps matching your credentials.
1

Navigate to Workflow Board

In the improver panel, go to the “Workflow Board” tab.
2

Search and Filter

Use the search box to find workflows by title or keywords.
3

Review Workflow Details

Click on any workflow card to open details and see:
  • Workflow title, description, and start date
  • Total bounty and recurrence pattern
  • All steps with role requirements and bounties
  • Work item requirements (photos, written responses, dropdowns)
4

Identify Claimable Steps

Look for steps marked as “Available” or “Locked” where:
  • You have the required credentials
  • You haven’t already claimed a step in this workflow
  • The step is not covered by your absence period

​
Claiming a Step

1

Open Workflow Details

Click on a workflow to open the details modal.
2

Navigate to the Step

Use the step navigation arrows or step selector to find the claimable step.
3

Click 'Claim This Step'

Click the “Claim This Step” button.The step is immediately assigned to you.
4

Step Status Changes

  • Locked steps become Available when the prior step completes
  • Available steps can be claimed immediately
  • Once claimed, only you can work on this step
You can only claim ONE step per workflow. Plan carefully - you can’t claim multiple steps in the same workflow.

​
Completing Workflow Steps

​
Starting a Step

1

Open Your Workflows

Navigate to the “My Workflows” tab to see all workflows where you’ve claimed a step.
2

Select a Workflow

Click on a workflow card to open details.
3

Start the Step

If the step is in “Available” status, click “Start This Step” to change status to “In Progress”.This marks the step as actively being worked on.

​
Submitting Work Items

Each step has work items that require evidence. Work items can require:
  • Photos: Upload or capture images
  • Written Responses: Provide text descriptions or notes
  • Dropdown Selections: Choose from predefined options
Some work items are optional and others are required.

​
Submitting Photos

1

Review Photo Requirements

Check the work item details:
  • Aspect ratio: Vertical (3:4), Square (1:1), or Horizontal (4:3)
  • Required count: Exact number of photos needed
  • Allow any count: Can upload more than the required count
  • Camera capture only: Must use camera (no file uploads)
2

Choose Upload Method

File Upload (if allowed):
  • Click “Choose Files” or drag and drop
  • Select image files (JPG, PNG, etc.)
  • Files are automatically resized to fit 2MB limit
  • Photos are cropped to match required aspect ratio
Camera Capture:
  • Click “Open Camera”
  • Grant camera permissions if prompted
  • Click “Capture Photo” to take a picture
  • The photo is automatically cropped to the required aspect ratio
  • Click “Close Camera” when done
3

Review and Remove Photos

  • Click on photo thumbnails to preview full size
  • Click “Remove” to delete unwanted photos
  • Add more photos until you meet the required count
Use “Camera Capture Only” work items to ensure fresh, on-site photos (not old uploads).

​
Submitting Written Responses

For work items requiring text:
1

Enter Your Response

Type your response in the textarea field.
2

Provide Sufficient Detail

Include:
  • Observations and findings
  • Context and circumstances
  • Any issues or concerns
  • Recommendations or follow-up items

​
Submitting Dropdown Selections

For work items with dropdown options:
1

Select an Option

Choose the appropriate option from the dropdown.
2

Provide Written Response (if required)

Some dropdown options require additional written explanation. If so, a textarea will appear after selection.
Dropdown selections can trigger notification emails to external stakeholders (e.g., selecting “Equipment Damaged” might alert maintenance staff).

​
Reporting Step Not Possible

If a step cannot be completed (e.g., location inaccessible, equipment missing):
1

Check for 'Step Not Possible' Option

Some steps allow improvers to report inability to complete.
2

Select 'This step is not possible to complete'

Check the checkbox.
3

Provide Detailed Explanation

Describe:
  • Why the step cannot be completed
  • What prevented completion
  • When it might be possible (if known)
4

Submit Completion

Click “Complete This Step” to submit.
“Step Not Possible” submissions still count as completion and earn the bounty. Only use this option when genuinely unable to complete the work.

​
Completing the Step

1

Review All Work Items

Ensure you’ve completed all required work items:
  • Photos uploaded/captured (correct count)
  • Written responses provided where required
  • Dropdown selections made
2

Click 'Complete This Step'

Submit the step for completion.
3

Handle Errors

If submission fails, review error messages:
  • Missing required photo count
  • Missing written responses
  • Missing dropdown selections
  • Photos exceeding 2MB limit
Fix issues and resubmit.
4

Step Marked Complete

Once submitted successfully:
  • Step status changes to “Completed”
  • Next step in the workflow becomes available (if sequential)
  • Payout is processed automatically

​
Managing Absence Periods

If you can’t work on recurring workflows for a period of time (vacation, illness, etc.), create absence periods to automatically release your claims.

​
Creating Absence Periods

1

Navigate to Absence Periods Tab

In the improver panel, go to the “Absence Periods” tab.
2

Choose Target Mode

Select:
  • Single: Apply absence to one specific recurring workflow step
  • All: Apply absence to all your recurring workflow claims
3

Select Date Range

  • Absent From: First day of absence (inclusive)
  • Absent Until: Last day of absence (exclusive)
Example: Absent from 2024-03-01 until 2024-03-15 means you’re absent from March 1-14.
4

Create Absence Period

Click “Create Absence Period”.The system:
  • Releases any assigned workflow steps that fall within the absence period
  • Prevents claiming new steps in that series during the absence
  • Shows released count and skipped count (steps already in progress)
Absence periods only affect recurring workflows (daily, weekly, monthly). One-time workflows are not affected.

​
Editing and Deleting Absence Periods

1

View Existing Periods

In the “Absence Periods” tab, see all your absence periods.
2

Edit a Period

Click “Edit” to change the date range, then save.
3

Delete a Period

Click “Delete” and confirm to remove the absence period.Deleting does NOT automatically re-claim released steps.

​
Unclaiming Recurring Workflow Series

To permanently release all claims in a recurring workflow series:
1

Open Workflow Details

In “My Workflows” tab, open the recurring workflow you want to unclaim.
2

Click 'Unclaim Series'

Confirm the action.
3

All Claims Released

The system releases all your future claims in this series.Steps already “In Progress” or “Completed” are not affected.
Unclaiming a series cannot be undone. You’ll need to re-claim steps individually if you change your mind.

​
Viewing Your Workflows

​
My Workflows Tab

The “My Workflows” tab shows all workflows where you’ve claimed a step, organized by series. Series Cards:
  • Recurring workflows are grouped by series
  • Navigate through instances using left/right arrows
  • Filter: Show only active series (hide completed series)
  • Search by workflow title
Workflow Details:
  • Click any workflow to open full details
  • See your assigned step(s) and completion status
  • View other improvers’ work on different steps
  • Track workflow overall progress

​
Unpaid Workflows Tab

The “Unpaid Workflows” tab shows completed workflows awaiting payout.
1

Check Payout Status

Workflows move from “Completed” to “Paid Out” when all payouts succeed.
2

Request Payout Retry

If payout fails (e.g., network issues), click “Request Payout Retry” to ask an admin to retry the transaction.

​
Earnings and Payouts

​
How Payouts Work

  1. Complete Step: Submit all required work items
  2. Automatic Payout: The system attempts to transfer your bounty to your primary rewards account
  3. Payout Success: Step status changes to “Paid Out”
  4. Payout Failure: If payout fails, you can request a retry

​
Setting Primary Rewards Account

1

Navigate to Settings

Go to /settings in your account.
2

Set Primary Rewards Account

Select which wallet address should receive improver payouts.
Always verify your primary rewards account is set before claiming steps to ensure payouts reach the correct wallet.

​
Best Practices

  • Review work requirements before claiming
  • Ensure you can access the location (for field work)
  • Have necessary equipment (camera, tools, etc.)
  • Can complete within reasonable timeframe
  • Take clear, well-lit photos
  • Capture relevant details in photos
  • Provide thorough written responses
  • Answer dropdown questions accurately
  • Include context and observations
  • Don’t claim steps you can’t complete soon
  • Unclaim if circumstances change
  • Use absence periods for planned unavailability
  • Communicate with proposers about issues
  • Use absence periods for vacations
  • Don’t over-claim recurring workflows
  • Balance one-time and recurring work
  • Track your completion rate
  • Request credentials for workflow types you want to work on
  • Complete training required for credentials
  • Maintain credentials by following issuer requirements
  • Track which credentials unlock high-value workflows

​
Troubleshooting

Possible reasons:
  • You don’t have required credentials
  • You already claimed a step in this workflow
  • The step is covered by your absence period
  • Another improver already claimed it
  • The step is “Locked” (prior step not complete)
Solution: Request needed credentials, wait for step to unlock, or find other workflows.
Common issues:
  • File size exceeds 2MB (system auto-compresses, but very large images may still fail)
  • Unsupported file format (use JPG or PNG)
  • Wrong aspect ratio (system auto-crops, but check work item requirements)
Solution: Use smaller images, check file format, or use camera capture.
  • Grant camera permissions in your browser
  • Check browser compatibility (Chrome, Firefox, Safari recommended)
  • Ensure camera is not in use by another app
  • Try refreshing the page
Error messages indicate missing requirements:
  • “Missing response for required work item”: Fill in all required fields
  • “Exactly N photos required”: Upload correct photo count
  • “Dropdown selection is required”: Choose dropdown option
  • “Written response is required”: Add text response
Solution: Review error message and complete missing items.
Check:
  • Step status (should be “Paid Out”)
  • Primary rewards account is set correctly
  • Wallet address is valid
  • Check blockchain explorer for transaction
Solution: Request payout retry if step shows payout error.

​
API Endpoints Reference

Improver routes (require improver or admin role):
  • POST /improvers/request - Request improver status
  • GET /improvers/workflows - Fetch workflow feed
  • GET /improvers/unpaid-workflows - Fetch unpaid workflows
  • POST /improvers/workflows/{workflow_id}/steps/{step_id}/claim - Claim step
  • POST /improvers/workflows/{workflow_id}/steps/{step_id}/start - Start step
  • POST /improvers/workflows/{workflow_id}/steps/{step_id}/complete - Complete step
  • POST /improvers/workflows/{workflow_id}/steps/{step_id}/payout-request - Request payout retry
  • PUT /improvers/primary-rewards-account - Set rewards account
  • GET /improvers/workflows/absence-periods - List absence periods
  • POST /improvers/workflows/absence-periods - Create absence period
  • PUT /improvers/workflows/absence-periods/{absence_id} - Update absence period
  • DELETE /improvers/workflows/absence-periods/{absence_id} - Delete absence period
  • POST /improvers/workflow-series/unclaim - Unclaim series
  • GET /improvers/credential-requests - List credential requests
  • POST /improvers/credential-requests - Request credential

Build docs developers (and LLMs) love

Get started for freeTalk to us