> ## Documentation Index
> Fetch the complete documentation index at: https://help.classcents.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Student Dashboard Access

> How students access and use their ClassCents dashboard

## Overview

Students access their own personal dashboard to view their balance, shop for rewards, participate in auctions, and track their progress - all without needing a password!

<img src="https://mintcdn.com/joshuamakes/G5j-M0tSaQs4mL9T/images/students/student-dashboard.png?fit=max&auto=format&n=G5j-M0tSaQs4mL9T&q=85&s=3a7315a1a49c809575ee3ff8fa408d0b" alt="Student dashboard showing balance, quick actions, and navigation" width="1600" height="1000" data-path="images/students/student-dashboard.png" />

## Access Methods

There are two ways students can sign in — both passwordless. Each student has a unique **QR code** and a **PIN code**.

<Tabs>
  <Tab title="QR Code Login (Recommended)">
    **Easiest for K-8 students**

    <Steps>
      <Step title="Teacher Prints QR Cards">
        Open the classroom → **QR Codes** tab → **Print Cards** sub-tab → select students → click **Print Cards**. Each card shows the student's name, QR code, and PIN.
      </Step>

      <Step title="Student Receives Card">
        Hand out the printed cards. Students keep them in a folder, planner, or laminated.
      </Step>

      <Step title="Student Scans Code">
        Use a phone, tablet, or Chromebook camera to scan the QR code.
      </Step>

      <Step title="Instant Access">
        The browser opens directly into that student's dashboard.
      </Step>
    </Steps>
  </Tab>

  <Tab title="PIN Code Login">
    **Best for shared classroom devices**

    <Steps>
      <Step title="Open the Student Login Page">
        Students go to your classroom's student login URL on a shared device.
      </Step>

      <Step title="Pick Their Name">
        Students select themselves from the class roster.
      </Step>

      <Step title="Enter PIN">
        They type the PIN printed on their card to sign in.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Direct URL Access">
    **For bookmarking on personal devices**

    Each student has a unique dashboard URL:

    ```
    https://classcents.com/student/dashboard/[nano_id]
    ```

    The nano ID is a cryptographically random identifier — not guessable, and treated like a credential. Students can bookmark this on their device for one-tap access.
  </Tab>
</Tabs>

## What Students Can See

<CardGroup cols={2}>
  <Card title="Current Balance" icon="wallet">
    * Total currency available
    * Recent transactions
    * Earning history
    * Savings progress toward goals
  </Card>

  <Card title="Rewards Shop" icon="store">
    * Browse available rewards
    * See prices and descriptions
    * Purchase rewards directly
    * View purchase history
  </Card>

  <Card title="Active Auctions" icon="gavel">
    * See current auctions
    * Place and manage bids
    * View auction history
    * Track wins and losses
  </Card>

  <Card title="Achievements" icon="trophy">
    * Earned badges display
    * Progress toward next badges
    * Total achievements count
    * Badge showcase
  </Card>

  <Card title="Classroom Jobs" icon="briefcase">
    * Current job assignments
    * Payment schedule
    * Apply for available jobs
    * Job history
  </Card>

  <Card title="Leaderboard" icon="ranking-star">
    * Class ranking (if enabled)
    * Top earners
    * Achievement leaders
    * Friendly competition
  </Card>
</CardGroup>

## Student Dashboard Features

### Purchasing Rewards

<Steps>
  <Step title="Browse Shop">
    Student views available rewards and prices
  </Step>

  <Step title="Select Reward">
    Click on desired reward to see full details
  </Step>

  <Step title="Confirm Purchase">
    Click **Buy Now** - amount is deducted immediately
  </Step>

  <Step title="Await Fulfillment">
    Dashboard shows "Pending" until teacher delivers the reward
  </Step>
</Steps>

<Info>
  Students can only purchase if they have sufficient balance - the system prevents overdrafts automatically unless teacher configured otherwise.
</Info>

### Bidding in Auctions

<Steps>
  <Step title="View Active Auctions">
    All current auctions shown with time remaining
  </Step>

  <Step title="Place Bid">
    * Enter amount (must be higher than current bid)
    * Funds are reserved but not yet deducted
    * Can place multiple bids on different auctions
  </Step>

  <Step title="Monitor Status">
    * See if outbid (funds released)
    * Place new higher bid if desired
    * Wait for auction to end
  </Step>

  <Step title="Winner Announcement">
    If won, currency deducted and reward marked for pickup
  </Step>
</Steps>

### Setting Personal Goals

Students can set savings goals:

1. Enter goal name (e.g., "Save for Homework Pass")
2. Set target amount
3. Dashboard shows progress bar toward goal
4. Motivates delayed gratification

## Mobile-Friendly Design

The student dashboard is fully responsive:

* **Phones**: Clean single-column layout
* **Tablets**: Two-column for shopping
* **Chromebooks**: Full dashboard experience
* **Desktop**: Large, easy-to-read displays

<Tip>
  Works great on any device - from parent's phone to classroom Chromebook!
</Tip>

## Privacy & Security

<AccordionGroup>
  <Accordion title="What Students CAN See" icon="eye">
    * Their own balance and transaction history
    * Available rewards and auctions
    * Their earned badges
    * Their job assignments
    * Classroom leaderboard (if enabled)
  </Accordion>

  <Accordion title="What Students CANNOT See" icon="eye-slash">
    * Other students' balances
    * Other students' transaction details
    * Teacher controls and settings
    * Admin features
    * Other classrooms' data
  </Accordion>

  <Accordion title="No Password Required" icon="lock-open">
    QR code system is secure because:

    * Unique nano IDs are cryptographically generated
    * URLs not easily guessable
    * Can regenerate codes if compromised
    * Students can't access other accounts
  </Accordion>
</AccordionGroup>

## Teacher Controls

Classroom-wide controls available to teachers:

* **Refresh Access** (QR Codes tab) — generates a new QR + PIN for selected students. Old printed cards stop working immediately.
* **Investments / Market** (Settings → Classroom Settings → Investments) — toggle the Investments tab on or off per classroom.
* **Bills** (Classroom → Expenses) — enable or disable bill assignments per classroom.
* **Payment Schedule** (Settings → Classroom Settings → Payment Schedule) — control when job payments and bill deductions process.

## Common Questions

<AccordionGroup>
  <Accordion title="Can students access from home?" icon="house">
    **Yes!** Students can access their dashboard from any device, anywhere with internet.

    This is great for:

    * Showing parents their progress
    * Shopping for rewards at home
    * Checking balance before school
    * Building excitement outside classroom
  </Accordion>

  <Accordion title="What if a student loses their card?" icon="circle-question">
    **Easy fix**:

    1. Open the classroom's **QR Codes** tab
    2. Select the student and click **Refresh Access**
    3. A new QR code and PIN are generated; the old card stops working
    4. Print and hand out the new card
    5. All balances, badges, and history are preserved
  </Accordion>

  <Accordion title="Can students change their own balance?" icon="pen">
    **No!** Students have read-only access to their financial data. Only teachers can award or deduct currency through the teacher dashboard.
  </Accordion>

  <Accordion title="Is it safe for young students?" icon="shield">
    **Yes!** The dashboard is designed for K-8:

    * No personal information displayed
    * No external links or advertisements
    * Age-appropriate interface
    * Teacher-controlled access
  </Accordion>
</AccordionGroup>

## Troubleshooting Access Issues

<AccordionGroup>
  <Accordion title="QR Code Not Working" icon="qrcode">
    **Try**:

    1. Ensure good lighting for camera scan
    2. Hold camera steady and at proper distance
    3. Try different QR code scanning app
    4. Regenerate the QR code if damaged
  </Accordion>

  <Accordion title="Dashboard Shows Old Data" icon="arrows-rotate">
    **Solution**: Refresh the page

    Data updates in real-time, but browser may cache. Click refresh or F5.
  </Accordion>

  <Accordion title="Student Can't Purchase Rewards" icon="ban">
    **Check**:

    1. Student has sufficient balance
    2. Reward is marked as available
    3. Shop feature is enabled by teacher
    4. Reward hasn't reached quantity limit
  </Accordion>
</AccordionGroup>

## Related Topics

<CardGroup cols={2}>
  <Card title="QR Code System" icon="qrcode" href="/students/qr-codes">
    Detailed QR code setup and management
  </Card>

  <Card title="Earning & Spending" icon="coins" href="/students/earning-spending">
    How students earn and use currency
  </Card>
</CardGroup>
