사용 가이드

한국어

1. 뽀모도로 타이머

Focus Valley는 뽀모도로 기법을 사용합니다 — 집중 세션과 휴식을 번갈아 반복해요.

• 집중 — 25분 집중 작업 (1~120분 커스터마이즈 가능)
• 짧은 휴식 — 5분 휴식 (1~30분 커스터마이즈 가능)
• 긴 휴식 — 집중 4회 완료 후 15분 휴식 (1~60분 커스터마이즈 가능)

타이머는 Web Worker로 동작하기 때문에, 탭을 전환하거나 브라우저를 최소화해도 정확하게 계속 작동합니다. 세션이 끝나면 알림을 받을 수 있어요.

설정에서 자동 진행을 켜면 세션 완료 후 자동으로 다음 모드로 전환됩니다.

2. 식물 성장

집중 세션을 시작하면 식물이 실시간으로 자라요:

1. 씨앗 — 시작 상태
2. 새싹 — 초기 성장
3. 봉오리 — 중간 단계
4. 꽃 / 나무 — 세션 완료! 탭해서 수확하세요.

세션 도중 포기하면 식물이 시들어 죽지만, 5초 이내에 되돌리기가 가능합니다.

식물 종류 & 해금 조건

• 고사리기본 — 항상 사용 가능
• 선인장기본 — 항상 사용 가능
• 해바라기기본 — 항상 사용 가능
• 분재기본 — 항상 사용 가능
• 장미3일 연속 스트릭
• 난초7일 연속 스트릭
• 연꽃딥 포커스 3회
• 크리스탈딥 포커스 5회
• 대나무Pro 전용
• 벚꽃Pro 전용

3. 앰비언트 사운드

하단의 사운드 버튼을 클릭해서 믹서를 열어보세요. 최대 5개 채널을 동시에 블렌딩할 수 있어요:

• 비 — 잔잔한 빗소리
• 불 — 벽난로 소리
• 카페 — 카페 분위기
• 시냇물 — 흐르는 물소리
• 화이트 — 백색 소음

모든 소리는 고품질 오디오 루프로 제공됩니다 — Web Audio API로 원활하게 재생돼요.

4. 카테고리

집중 세션에 카테고리(공부, 코딩, 독서, 업무, 디자인, 운동)를 태그하여 시간 활용을 추적하세요. 이모지와 색상을 선택해서 커스텀 카테고리를 추가할 수도 있어요.

드래그로 카테고리 순서를 변경할 수 있습니다 (마우스: 클릭 후 드래그, 터치: 꾹 누른 후 드래그). 마우스 휠로도 카테고리 목록을 좌우로 스크롤할 수 있어요.

5. 할 일 목록

헤더의 목록 아이콘을 클릭하면 할 일 패널이 열립니다:

• 할 일을 추가하고 완료 표시
• 할 일을 집중 과제로 고정하면 작업 중 식물 아래에 표시돼요
• 완료된 항목 일괄 삭제

6. 정원 컬렉션

수확한 식물은 모두 정원 컬렉션에 저장됩니다 (헤더의 새싹 아이콘). 다음을 확인할 수 있어요:

• 식물 종류별 재배 횟수
• 잠금 해제된 식물 종류
• 현재 스트릭 & 최고 스트릭

7. 통계 & 기록

헤더의 기록 아이콘에서 집중 기록을 확인하세요:

• 활동 히트맵 — 최근 3개월 시각적 개요
• 주간 요약 — 총 시간, 일 평균, 지난주 대비 비교
• 카테고리별 분석 — 카테고리별 집중 시간 분포
• 공유 카드 — SNS 공유용 집중 카드 생성
• CSV 내보내기 — 세션 데이터 다운로드

8. 키보드 단축키

키	동작
Space	타이머 시작 / 일시정지
R	타이머 리셋
S	다음 모드로 건너뛰기
1	집중 모드로 전환
2	짧은 휴식으로 전환
3	긴 휴식으로 전환
M	사운드 믹서 열기/닫기
?	단축키 안내 보기

9. 호흡 가이드

휴식 시간에 호흡 버튼이 나타납니다. 4-7-8 호흡법으로 안내해요:

1. 들이쉬기 (4초)
2. 멈추기 (7초)
3. 내쉬기 (8초)

10. 앱 설치 (PWA)

Focus Valley는 프로그레시브 웹 앱(PWA)입니다. 설치하면 네이티브 앱처럼 사용할 수 있어요:

• 데스크톱 (Chrome) — 주소창의 설치 아이콘 클릭 또는 인앱 배너 사용
• iOS (Safari) — 공유 버튼 → 홈 화면에 추가
• Android (Chrome) — 설치 배너 또는 메뉴 → 홈 화면에 추가

11. 다크 / 라이트 모드

헤더의 해/달 아이콘으로 다크 모드와 라이트 모드를 전환할 수 있습니다. 설정은 로컬에 저장돼요.

오로라 애니메이션 색상은 현재 타이머 모드(집중, 짧은 휴식, 긴 휴식)에 따라 변합니다.

12. 클라우드 동기화

Google로 로그인하면 기기 간 데이터를 동기화할 수 있습니다:

• 정원 컬렉션 & 수확 기록
• 집중 세션 통계
• 타이머 설정 & 환경설정
• 할 일 목록
• 카테고리 설정

로그인 시 자동으로 동기화되며, 계정 패널에서 수동으로 실행할 수도 있어요.

13. 스트릭 & 잠금 해제

매일 최소 1회 집중 세션을 완료하면 스트릭이 유지됩니다. 스트릭 카운터는 Focus Valley 로고 옆에 표시돼요.

스트릭 마일스톤(3일, 7일)에서 새로운 식물이 해금됩니다. 딥 포커스(연속 집중 세션)로 연꽃과 크리스탈 같은 특별한 식물도 해금할 수 있어요. 대나무와 벚꽃은 Pro 전용입니다.

English

1. Pomodoro Timer

Focus Valley uses the Pomodoro Technique: focused work sessions followed by breaks.

• Focus — 25 minutes of concentrated work (customizable 1–120 min)
• Short Break — 5 minutes rest (customizable 1–30 min)
• Long Break — 15 minutes rest after every 4 focus sessions (customizable 1–60 min)

The timer runs in a Web Worker, so it keeps ticking even if you switch tabs or minimize the browser. You'll get a notification when a session ends.

You can enable Auto-advance in Settings to automatically switch to the next mode after completion.

2. Plant Growth

When you start a focus session, your plant begins to grow in real time:

1. Seed — Starting state
2. Sprout — Early growth
3. Bud — Mid-session
4. Flower / Tree — Session complete! Tap to harvest.

If you give up mid-session, the plant withers and dies (but you can undo within 5 seconds).

Plant Types & Unlock Conditions

• FernDefault — always available
• CactusDefault — always available
• SunflowerDefault — always available
• BonsaiDefault — always available
• Rose3-day streak
• Orchid7-day streak
• Lotus3x Deep Focus sessions
• Crystal5x Deep Focus sessions
• BambooPro only
• SakuraPro only

3. Ambient Sounds

Click Sounds at the bottom to open the mixer. You can blend up to 5 sound channels simultaneously:

• Rain — Gentle rain ambient
• Fire — Crackling fireplace
• Cafe — Coffee shop ambiance
• Stream — Flowing water
• White — White noise

Sounds are delivered as high-quality audio loops — played seamlessly via the Web Audio API.

4. Categories

Tag your focus sessions with categories (Study, Code, Read, Work, Design, Exercise) to track what you spend time on. You can also add custom categories with your own emoji and color.

Reorder categories by dragging (mouse: click-drag, touch: long-press then drag). You can also scroll through categories horizontally using the mouse wheel.

5. To-Do List

Open the to-do panel from the header (list icon) to manage tasks. You can:

• Add tasks and mark them complete
• Pin a task as your "focus task" — it shows below the plant while you work
• Clear all completed tasks at once

6. Garden Collection

Every harvested plant goes into your Garden Collection (sprout icon in the header). It tracks:

• How many of each plant type you've grown
• Which plant types you've unlocked
• Your current and best streaks

7. Stats & History

View your focus history from the header (scroll icon). Features include:

• Activity heatmap — Visual overview of the last 3 months
• Weekly summary — Total time, daily average, comparison with last week
• Category breakdown — How you distribute focus across categories
• Share card — Generate a visual summary to share on social media
• CSV export — Download your session data

8. Keyboard Shortcuts

Key	Action
Space	Start / Pause timer
R	Reset timer
S	Skip to next mode
1	Switch to Focus mode
2	Switch to Short Break
3	Switch to Long Break
M	Toggle sound mixer
?	Show shortcut guide

9. Breathing Guide

During breaks, a Breathe button appears. It guides you through a calming 4-7-8 breathing pattern:

1. Breathe in (4 seconds)
2. Hold (7 seconds)
3. Breathe out (8 seconds)

10. Install as App (PWA)

Focus Valley is a Progressive Web App. Install it for a native app-like experience:

• Desktop (Chrome) — Click the install icon in the address bar, or use the in-app banner
• iOS (Safari) — Tap Share → Add to Home Screen
• Android (Chrome) — Tap the install banner or Menu → Add to Home Screen

11. Dark / Light Mode

Toggle between dark and light modes using the Sun/Moon icon in the header. Your preference is saved locally.

The aurora animation colors change based on the current timer mode (Focus, Short Break, Long Break).

12. Cloud Sync

Sign in with Google to sync your data across devices. Cloud sync includes:

• Garden collection & harvest history
• Focus session statistics
• Timer settings & preferences
• To-do list
• Category configurations

Sync happens automatically on login and can be triggered manually from the account panel.

13. Streaks & Unlocks

Complete at least one focus session per day to maintain your streak. The streak counter appears next to the Focus Valley logo.

Streaks unlock new plant types at milestones (3 and 7 days). Deep Focus sessions (back-to-back focus sessions) unlock special plants like Lotus and Crystal. Bamboo and Sakura are Pro-only.