📱 위젯

iOS 또는 Android 홈 화면에서 ulives 데이터에 바로 접근하세요.

사용 시나리오

원탭 집중 — "독서", "업무", "운동" 등 서로 다른 할 일을 가리키는 Focus Duration 위젯을 여러 개 배치하세요. 한 번 탭하면 바로 몰입 상태에 들어갑니다.

목록 전환기 — Tasks List 위젯으로 앱 내비게이션 없이 "일일 할 일"이나 "프로젝트 할 일"로 바로 이동할 수 있습니다.

중요한 날짜 한눈에 — Countdown 및 Countdown List 위젯으로 중요한 날짜를 항상 확인하세요. 생일, 시험, 마감일을 놓치지 마세요.

매일의 영감 — Random 위젯(Random Achievement, Random Pending Task, Random Thought, Random Inventory)은 매일 예상치 못한 것을 보여 줍니다. 잊혀진 마일스톤, 놓친 할 일, 과거의 회고 등.

연속 동기부여 — Task Streak 위젯은 현재 연속 기록을 보여 주어 기록을 이어가도록 돕습니다.

한눈에 보는 개요 — Statistics 및 Heatmap 위젯으로 앱을 열지 않고도 진행 상황을 확인할 수 있습니다. 오늘의 활동 히트맵이나 7일 요약을 바로 볼 수 있습니다.

위젯 유형

ulives는 다음 카테고리의 위젯을 제공합니다.

카테고리	위젯	표시 내용
할 일	Tasks List, Task Status, Task Streak, Random Pending Task	할 일 목록, 완료 상태, 연속 기록, 무작위 대기 할 일
집중	Quick Access, Focus Duration	원탭 집중 시작 및 기간별 집중 통계
상점 및 인벤토리	Shop Overview, Item Count, Recent Item	상점 탐색, 인벤토리 수량, 최근 획득 아이템
업적	Overview, List Progress, Countdown, Countdown List, Single, Upcoming, Random Unlocked	업적 진행률, 카운트다운, 다음 목표, 무작위 추억
통계	Statistics Overview, Heatmap	오늘 통계 또는 7일 요약, 활동 히트맵
속성	Attribute List, Single Attribute, Random Attribute, Attribute Radar	속성 레벨, 무작위 스냅샷, 레이더 차트 비교
회고	Reflection Prompt, Random Reflection	일기 프롬프트, 무작위 과거 회고
기타	Random Inventory	가방에서 무작위 아이템

대부분의 위젯은 소형 크기를 지원하며, 일부는 중형과 대형도 제공합니다.

Android 참고: iOS에서 하나의 설정 화면을 공유하는 일부 위젯은 Android에서 별도 항목으로 표시됩니다(예: Statistics Today vs 7-Day, 상점 목록 모드, 업적 카운트). Android에는 Currency List와 Focus Summary 위젯도 포함됩니다.

🖥️ 시스템 요구 사항

iOS

기능	최소 버전
홈 화면 위젯	iOS 16.0+
위젯에서 할 일 직접 완료	iOS 17.0+
Focus Live Activity(잠금 화면 / Dynamic Island)	iOS 16.1+
Task Live Activity(잠금 화면)	iOS 17.0+
제어 센터 위젯	iOS 18.0+

Android

기능	요구 사항
홈 화면 위젯	Android 7.0+(API 24)
위젯에서 할 일 완료 / 조정	지원(앱 최소 요구 사항 외 추가 OS 버전 불필요)
Focus Live Activity	미지원 — Android에서는 집중 시 앱 내 오버레이 / 알림 사용

iOS 위젯 확장은 설정 및 인터랙티브 할 일 버튼을 위해 **iOS 17+**를 대상으로 합니다. 더 오래된 iOS 버전은 기기에 따라 위젯 지원이 제한될 수 있습니다.

위젯 추가 방법

iOS

1. 홈 화면의 빈 영역을 길게 누르 아이콘이 흔들릴 때까지 기다립니다
2. 「+」버튼(iOS 버전에 따라 왼쪽 또는 오른쪽 상단)을 탭한 뒤 ulives를 검색합니다
3. 사용 가능한 위젯을 둘러보고 크기를 스와이프로 선택한 뒤 **「위젯 추가」**를 탭하고 원하는 위치로 드래그합니다
4. (선택) 배치한 위젯을 길게 누르고 **「위젯 편집」**을 탭해 표시할 데이터를 설정합니다

ulives에서 설정 → 위젯을 열어 안내와 미리보기를 볼 수도 있습니다.

Android

1. 런처에서: 홈 화면 길게 누르기 → 위젯 → ulives 찾기 → 위젯과 크기 선택 → 배치. 설정 가능한 유형은 먼저 설정 화면이 열릴 수 있습니다.
2. 앱에서: 설정 → 위젯을 열고 카테고리별로 둘러본 뒤 추가를 탭합니다(런처가 지원하면 위젯이 바로 고정됩니다).
3. 나중에 재설정: 위젯 길게 누르기 → 재구성, 또는 설정 → 위젯에서 인스턴스를 편집합니다.

🎬 워크스루 GIF 곧 제공 예정

상호작용 및 팁

대부분의 위젯은 읽기 전용입니다 — 데이터를 표시하지만 편집은 지원하지 않습니다. 위젯을 탭하면 앱의 해당 화면이 열립니다.

위젯	탭 동작
Tasks List	해당 할 일 목록으로 앱 열기 — 목록 전환기로 유용
Focus Duration	선택한 할 일이 미리 채워진 Focus 페이지 열기, 바로 시작 가능
Countdown / Achievements	업적 상세 페이지 열기
Shop / Item Count	상점 또는 아이템 상세 페이지 열기
Statistics / Heatmap	통계 페이지 열기
Attribute / Radar	상태 페이지 열기

Tasks List, Task Status, Task Streak는 위젯 내 할 일 작업을 지원합니다.

• iOS 17+: 위젯에서 할 일을 직접 완료할 수 있습니다. 실수 방지를 위해 완료 취소는 앱 내에서 해야 합니다. 카드 자체를 탭하면 할 일 상세 페이지가 열립니다.
• Android: 작업이 가능할 때 위젯에서 완료, 카운터 조정, 취소를 직접 할 수 있습니다.

Live Activities(iOS 전용)

이것들은 홈 화면 위젯이 아닙니다 — 잠금 화면(집중의 경우 Dynamic Island)에 표시됩니다.

• Focus Live Activity — 집중 중 실시간 타이머(iOS 16.1+)
• Task Live Activity — 할 일 기간을 잠금 화면에 고정하고, 거기서 완료 또는 카운트 조정(iOS 17+)

Android에는 Live Activities가 없습니다. Android의 집중은 앱 내 오버레이와 알림을 사용합니다.

업적 카운트다운 위젯

두 가지 카운트다운 위젯 유형을 사용할 수 있습니다.

• Achievement Countdown — 단일 업적의 남은 일수 표시
• Countdown List — 목록의 여러 카운트다운을 한 번에 표시

사전 조건:

1. ulives에서 Achievements 탭으로 이동
2. Achievement List를 만들고 Display Mode를 **「Countdown」**으로 설정
3. 목록에 업적 추가 — 각 업적의 목표 날짜가 카운트다운이 됩니다

추가 방법: 사용 중인 플랫폼에 맞는 위젯 추가 방법 단계를 따른 뒤, 원하는 카운트다운 위젯을 검색하고 목록과 업적을 설정하세요.

⚠️ Countdown List 표시 스타일은 Premium Access가 필요합니다. 자세한 내용은 아래 Premium Access를 참고하세요.

Item Count 위젯

Item Count 위젯은 인벤토리 수량을 표시할 뿐 아니라 탭 시 동작도 사용자 지정할 수 있습니다.

• Purchase 모드 — 탭 시 상점 페이지를 열어 아이템을 바로 구매
• Use 모드 — 탭 시 대화상자를 열어 아이템을 즉시 사용

위젯 편집 시 「Tap Action」 설정을 전환해 원하는 동작을 선택하세요. 자주 쓰는 소모품(커피, 에너지 포션 등)을 홈 화면에서 원탭으로 쓰기에 편리합니다.

Premium Access

위젯에 Premium Access가 필요한가요? 아니요. 모든 위젯은 무료이며 모든 사용자가 추가하고 사용할 수 있습니다. 멤버십 없이도 이용 가능합니다.

다만 앱 내 위젯 관련 기능 중 일부는 제한될 수 있습니다.

• Countdown List 표시 스타일을 만들려면 Premium Access가 필요합니다. 프리미엄 회원이 아니라면 앱에서 업그레이드하여 이 스타일을 잠금 해제한 뒤 위젯을 설정할 수 있습니다.

위젯 자체는 잠기지 않습니다 — 제한은 앱 내 기본 콘텐츠를 만들거나 편집할 때만 적용됩니다.

데이터 및 새로고침

앱에서 변경하면 양쪽 플랫폼 모두에서 위젯이 자동으로 업데이트됩니다. Random 위젯도 다른 콘텐츠를 보여 주기 위해 약 30–60분마다(플랫폼 및 위젯 유형에 따라) 스스로 새로고침합니다.

	iOS	Android
앱 내 변경 후	WidgetKit 타임라인 재로드로 즉시	Glance 위젯 업데이트로 즉시
시스템 백그라운드 새로고침	위젯 유형당 보통 15–60분	할 일 관련 위젯의 OS 예약 새로고침 최소 30분; 기타는 앱 이벤트 및 일일 경계 새로고침
날짜 변경	타임라인 새로고침 + 앱 이벤트	현지 자정 전후 예약 새로고침

앱을 최근에 열지 않았다면 위젯 업데이트는 최선 노력(best-effort) 입니다 — 앱을 쓰지 않고 초 단위 변화를 기대하지 마세요.

피드백

새 위젯 제안이나 문제가 있으신가요? 알려 주시면 감사하겠습니다.

• 📋 피드백 양식
• 📧 이메일: fb@ulives.io