# 🏠 Welcome to Soroban Mastery

Your complete interactive learning platform for mastering the Japanese abacus

📚

### Complete Guide

Learn to read numbers and perform arithmetic operations with step-by-step visual tutorials

🎯

### Interactive Challenges

Test your skills with engaging games including speed reading challenges and pattern matching

📊

### Practice Flashcards

Master number recognition with beautiful, customizable flashcards and printable PDF sets

⚙️

### Customization

Personalize your learning experience with different color schemes, card layouts, and difficulty levels

## Quick Start Guide

1

#### Learn the Basics

Start with our complete guide to understand how to read numbers on the soroban

2

#### Practice Recognition

Use interactive flashcards to build speed and accuracy in number recognition

3

#### Challenge Yourself

Test your skills with timed challenges and competitive games

4

#### Master Arithmetic

Learn advanced techniques for addition, subtraction, and more complex operations

### What You Will Learn

3
Practice Numbers
4
Game Modes
5
Color Schemes
∞
Skill Levels

## 📚 Complete Soroban Mastery Guide

From basic reading to advanced arithmetic - everything you need to master the Japanese abacus

### 1Understanding the Structure

The soroban has heaven beads (top) and earth beads (bottom) separated by a horizontal bar.

- Heaven bead: Worth 5 units
- Earth beads: Worth 1 unit each
- Active position: Beads pushed toward the bar

Zero (0) - All beads away from bar

### 2Reading Single Digits (1-9)

1 = One earth bead up
3 = Three earth beads up
5 = Heaven bead down
7 = Heaven bead + 2 earth beads
9 = Heaven bead + 4 earth beads

### 3Multi-Digit Numbers

Each column represents a place value. Read from right to left: ones, tens, hundreds, thousands.

23 = 2 tens + 3 ones
Tens: 2 | Ones: 3
67 = 6 tens + 7 ones
Tens: 6 | Ones: 7
158 = 1 hundred + 5 tens + 8 ones
Hundreds: 1 | Tens: 5 | Ones: 8

### 4Practice Strategy

#### Start Simple, Build Complexity

1. Master single digits (0-9) first
2. Practice two-digit numbers (10-99)
3. Advance to three-digit numbers (100-999)
4. Challenge yourself with larger numbers

#### Reading Strategy

For each column, count the active beads:

- Heaven bead down = add 5
- Earth beads up = add 1 each
- Total the values for each column

Practice Number
Try to read this number before revealing!

### 🧮 Soroban Arithmetic Mastery

Learn traditional Japanese calculation techniques step-by-step with visual examples

### +Addition Techniques

Addition on the soroban follows specific rules for manipulating beads efficiently. Master these fundamental patterns:

#### Simple Addition (No Carries)

##### Example: 23 + 14 = 37

Add ones first, then tens. No carrying required.

Start: 23
+4 ones →
Add 4 to ones: 27
+1 ten →
Final: 37

#### Addition with Carrying

##### Example: 47 + 28 = 75

When ones exceed 9, carry to tens column.

1. Start with 47 on the abacus
2. Add 8 to ones: 7 + 8 = 15 (carry 1)
3. Place 5 in ones, carry 1 to tens
4. Add 2 + 1 (carry) = 3 to tens: 4 + 3 = 7

Start: 47
+8 ones
(7+8=15) →
Carry: 55
+2 tens →
Final: 75

### −Subtraction Techniques

Subtraction requires understanding complement methods and borrowing. These are traditional soroban techniques.

#### Simple Subtraction (No Borrowing)

##### Example: 89 - 34 = 55

Subtract ones first, then tens. No borrowing needed.

Start: 89
-4 ones →
After -4: 85
-3 tens →
Final: 55

#### Complement Method (Advanced)

##### Five Complement Rule

When subtracting from 5, use complement pairs:

5 - 1 = 4 → Remove heaven, add 4 earth
5 - 2 = 3 → Remove heaven, add 3 earth
5 - 3 = 2 → Remove heaven, add 2 earth
5 - 4 = 1 → Remove heaven, add 1 earth

##### Ten Complement Rule

When borrowing from next column:

10 - 1 = 9 → Borrow 1, add 9
10 - 7 = 3 → Borrow 1, add 3
10 - 8 = 2 → Borrow 1, add 2

### ×Multiplication Methods

Soroban multiplication uses repeated addition and special column techniques for efficiency.

#### Single-Digit Multiplication

##### Example: 23 × 4 = 92

Multiply each digit by 4, handling carries properly.

1. Set up 23 on the left, multiply by 4
2. 3 × 4 = 12 → Write 2, carry 1
3. 2 × 4 = 8, plus carry 1 = 9
4. Result: 92

Setup: 23 × 4
Result: 92

#### Traditional Multiplication Layout

##### Column Arrangement

Traditional soroban multiplication uses specific column arrangements:

- Multiplicand: Left side of abacus
- Multiplier: Right side of abacus
- Product: Center columns for result
- Working space: Extra columns for carries

### ÷Division Techniques

Division on soroban uses traditional algorithms with quotient estimation and remainder handling.

#### Simple Division

##### Example: 84 ÷ 4 = 21

Divide left to right, estimating quotient digits.

1. Set dividend 84 on left side
2. 8 ÷ 4 = 2 → Place 2 in quotient
3. 4 ÷ 4 = 1 → Place 1 in quotient
4. Result: 21

Dividend: 84
Quotient: 21

#### Traditional Division Layout

##### Column Organization

- Dividend: Starting on left columns
- Divisor: Held in memory or right side
- Quotient: Built up in designated columns
- Remainder: Left in dividend columns

### 💡Mastery Tips

#### 🎯 Accuracy First

Master accuracy before attempting speed. Slow, correct movements build muscle memory for rapid calculation.

#### 🔄 Practice Complements

Memorize 5-complements (1-4, 2-3) and 10-complements (1-9, 2-8, 3-7, 4-6) for efficient subtraction.

#### 👁️ Visualization

Learn to see numbers as bead patterns. This enables mental soroban calculation without the physical device.

#### 📚 Progressive Learning

Master single digits → two digits → three digits. Build complexity gradually for solid foundation.

## ⚙️ Current Configuration

Settings used for this flashcard set

Cards: 3
Range: 1 - 21
Color Scheme: All beads are the same color
Bead Shape: Diamond

### Configuration Details:

This flashcard set has been generated with specific settings to help you practice. You can generate new sets with different ranges, color schemes, and visual styles using the command-line tools.

#### Available Options:

- Number Ranges: Practice with any range from 0-99999
- Color Schemes: Monochrome, place-value, heaven-earth, alternating
- Bead Shapes: Diamond, circle, square
- Visual Styles: Multiple colorblind-friendly palettes

## 🎯 Interactive Challenges

Test your soroban skills with engaging games and quizzes

### 🧠 Memory & Speed

### 🎲 Logic & Patterns

## Speed Memory Quiz

Test your soroban reading skills! Cards will be shown briefly, then you'll enter the numbers you remember.

Cards to Quiz:
Display Time per Card:
2.0s
Card 1 of 10
Get Ready...

### Enter the Numbers You Remember

Cards shown: 0
Guesses left: 0
Found: 0
Type the numbers you remember:

### Quiz Results

0%

Score: 0 / 0 correct

Time per card: 2.0s

#### Detailed Results:

## Card Sorting Challenge

Click cards and positions to arrange them in ascending order (smallest to largest). No numerals shown - rely on reading the abacus!

Cards to Sort:
Ready to start
0:00

Instructions: Click a card → Click position or + button to place. Click placed cards to move back.

#### Available Cards

#### Sorting Positions (Smallest → Largest)

### 🎯 Sorting Challenge Results

## Matching Pairs Challenge

Match abacus patterns with their corresponding numerals. Find all pairs in minimum moves!

Game Mode:
Turn Timer:
Choose Grid Size to Start:
Ready to start
Moves: 0 Pairs: 0/0
0:00
🔵 Player 1 0 pairs
🔵 Player 1's Turn
30s
🟠 Player 2 0 pairs

Instructions: Click two cards to flip them. Purple cards (🧮) contain abacus patterns, green cards (🔢) contain numbers. Match abacus patterns with their corresponding numbers. Complete all pairs with minimum moves!

### 🧩 Matching Pairs Results

## Speed Complement Race

Lightning-fast complement training! Type the complement as quickly as possible.

Training Mode:
Game Style:
Score: 0
Streak: 0
Time: 0s
7
What makes 10?
7 + 3 = 10
0/10 Complete

### 🔥 Complement Race Results

## 🧮 Practice Flashcards

Interactive cards for hands-on learning

#1
1
#2
11
#3
21

Interactive flashcards for digital learning. Use the left/right arrow keys or click the cards to flip them.