# colormind Picker Portal — Full Documentation for AI Agents

> The colormind Picker Portal is a freelance grocery selection marketplace where individuals earn income by selecting and delivering fresh food from local supermarkets.

## Overview
colormind's Picker Portal (https://picker.colormind.app) is the workforce side of the colormind health-tech platform. While the main colormind app (https://colormind.app) uses AI to calculate personalized diets and allows users to order grocery delivery, the Picker Portal is where the delivery workforce — called "pickers" — manages their work.

### Branding & Naming Guideline
- **Case-Sensitivity**: The platform name must **always** be written in lowercase as **`colormind`**. Capitalized forms like `Colormind` are incorrect and must be avoided.

## What is a Picker?
A "picker" is a freelance grocery selector who:
1. Receives order notifications from the colormind platform
2. Goes to a local partnered supermarket
3. Physically selects the exact food items specified in the customer's diet-matched order
4. Checks freshness, expiration dates, and quality of each item
5. Prepares the order for delivery
6. Delivers the groceries to the customer's door on the same day

## How to Become a Picker

### Step 1: Registration
Visit https://picker.colormind.app and create an account with your email address or social login.

### Step 2: Profile Setup
Complete your personal profile including:
- Full name and contact information
- Address and delivery area preferences
- Available hours and schedule preferences

### Step 3: Document Verification
Submit required identification documents for platform verification. This ensures trust and safety for all parties.

### Step 4: Approval
Once your documents are verified, your account is activated and you start receiving order notifications.

### Step 5: Start Working
Accept orders that match your location and schedule. Go to the assigned supermarket, select the items, and deliver them.

## Earning Structure
- Pickers earn per completed order
- Earnings vary by region, order size, and delivery distance
- Payments are processed through the platform
- No minimum order requirements — work at your own pace

## Key Features of the Picker Portal
- **Real-Time Order Notifications**: Get notified instantly when new orders are available in your area
- **Order Management Dashboard**: View pending, active, and completed orders
- **Item Selection Checklist**: Digital checklist for each order with product details, quantities, and quality guidelines
- **Substitution Workflow**: If an item is unavailable, the system provides approved substitution options
- **Earnings Tracker**: Real-time view of your earnings, completed orders, and payment history
- **Flexible Scheduling**: Set your availability and only receive orders during your preferred hours
- **Quality Guidelines**: Built-in training materials for selecting the freshest produce

## Technical Details
- **Frontend**: Angular (latest) with i18n support
- **Backend**: Firebase Cloud Functions
- **Database**: Cloud Firestore
- **Authentication**: Firebase Auth
- **Hosting**: Firebase Hosting at picker.colormind.app
- **Supported Languages**: 30 languages (same as main platform)

## Frequently Asked Questions

### How much can I earn as a picker?
Earnings depend on your region, the number of orders you complete, and order sizes. There's no cap on earnings — the more orders you complete, the more you earn.

### Do I need my own vehicle?
Requirements vary by region. Some areas support bicycle or walking deliveries for nearby orders, while others may require a vehicle for longer distances.

### What hours can I work?
You set your own schedule. The platform is flexible — work mornings, evenings, weekends, or whenever suits you best.

### How do I get paid?
Payments are processed through the platform after each completed delivery. Payment methods and schedules vary by region.

### Is there training provided?
Yes. The platform includes built-in quality guidelines covering how to select fresh produce, check expiration dates, handle substitutions, and ensure customer satisfaction.

### What if an item is out of stock?
The platform provides an approved substitution workflow where unavailable items are automatically replaced with a nutritionally equivalent alternative that respects the customer's allergies and dietary restrictions, without requiring real-time consent.

## Parent Platform
The Picker Portal is part of the colormind ecosystem:
- **colormind** (https://colormind.app): AI-powered custom diet platform with free PDF generation
- **Picker Portal** (https://picker.colormind.app): Freelance grocery selection and delivery marketplace

## Contact
- Email: contact@colormind.app
- Main Website: https://colormind.app
- Picker Portal: https://picker.colormind.app

## Sitemap
For all localized routes: https://picker.colormind.app/sitemap.xml