Expense Buddy: 로컬 우선 비용 추적 및 GitHub 동기화
Source: Dev.to
Overview
수년간 여러 비용 추적 앱을 써보면서 같은 문제에 계속 부딪혔습니다: 느린 흐름, 복잡한 화면, 그리고 내가 생각보다 많은 데이터를 넘겨주고 있다는 불안감. 그래서 직접 만들었습니다.
Expense Buddy는 프라이버시‑우선, 로컬‑우선 비용 추적기이며, 사용자를 방해하지 않습니다. React Native (Expo) 로 제작되었으며 기본적으로 모든 데이터를 기기 내에 보관하고, 선택적으로 GitHub 동기화를 통해 사용자가 직접 관리하는 개인 백업을 제공합니다.
Key Features
- 기본 로컬‑우선 – 데이터가 기기에 머무릅니다.
- 프라이버시 설계 – 분석, 광고, 데이터 판매가 없습니다.
- 대용량 데이터에서도 빠름 – 가벼운 UI와 가상화 리스트.
- 선택적 GitHub 동기화 – 여러 기기에서 데이터를 동기화합니다.
- 카테고리와 결제수단 태그를 이용한 일일 비용 기록.
- 과거 항목을 편집할 수 있는 전체 히스토리 뷰.
- GitHub 동기화를 위한 증분, 차등, 배치 커밋.
- 깊이 있는 분석: 카테고리·결제수단 별 분류, 결제수단 수준 분할, 지출 추세 차트.
- 색상과 아이콘을 지정할 수 있는 사용자 정의 카테고리.
- 저장된 결제수단(카드 및 UPI ID).
- 앱 내 “What’s New” 업데이트 노트.
- 설정에서 직접 이슈 보고.
- 라이트·다크 모드와 테마 인식 스타일링.
Dashboard
대시보드는 “일일 체크‑인” 화면으로, 최근 지출을 한눈에 보여주고 간단한 7일 추세를 표시합니다. 그래프를 탭하면 특정 날짜의 항목으로 바로 이동할 수 있습니다.
Adding an Expense
비용을 추가하는 과정은 의도적으로 간단합니다—한 화면 흐름에 빠른 카테고리와 결제수단 선택을 제공해 몇 초 안에 기록하고 넘어갈 수 있습니다.
Analytics
분석 탭에서는 돈이 어디로 흐르는지 다음 기준으로 확인할 수 있습니다:
- 카테고리
- 결제수단
- 저장된 결제수단
또한 지출 추세를 확인하고 여러 기간(예: “이번 주” vs. “지난 3개월”)을 화면을 떠나지 않고 비교할 수 있습니다.
History
히스토리 뷰에서는 과거 항목을 탐색하고, 원하는 비용을 열어 바로 수정할 수 있습니다—별도의 편집 모드나 찾기 과정이 필요 없습니다.
Settings
설정은 고의적으로 단순합니다:
- 기본 결제수단 설정.
- 사용자 정의 카테고리 추가·편집 (앱에는 기본 8개 카테고리가 포함되어 있습니다).
- 더 깊은 분석을 위한 저장된 결제수단 관리.
- GitHub 동기화 활성화로 여러 기기에서 데이터 동기화.
- 변경 시 자동 동기화 또는 앱 실행 시 자동 동기화 선택.
GitHub Sync (Optional)
안전하고 예측 가능하며 완전히 선택적인 설계:
- 일일 CSV 파일 – 비용은
expenses-YYYY-MM-DD.csv형태로 레포에 저장됩니다. - 병합‑우선 워크플로 – fetch → merge → push 순서로 진행해 우발적인 데이터 손실을 방지합니다.
- 충돌 처리 – 타임스탬프 기반 해결; 실제 충돌이 발생할 때만 프롬프트를 표시합니다.
- 차등 업로드 – 변경된 파일만 업로드하고, 하나의 커밋으로 배치합니다.
- 설정 동기화 – 카테고리와 저장된 결제수단은
settings.json을 통해 동기화될 수 있습니다.
Performance
나는 끊김 없는 리스트를 강력히 선호하기 때문에 성능을 1급 목표로 삼았습니다. 가상화 리스트, 메모이제이션된 컴포넌트, 가벼운 상태 레이어 덕분에 긴 히스토리에서도 UI가 빠르게 반응합니다. UI가 최소화돼 있어 비용을 기록하는 데 몇 초면 충분합니다.
Availability
- 앱 사용에 필수 외부 계정이 없습니다.
- GitHub 동기화는 선택 사항이며, 파일은 사용자의 레포에 (일일 CSV) 저장됩니다.
- 데이터 판매가 없습니다.
Expense Buddy는 현재 Google Play에서 내부 테스트 중입니다. 접근을 원하시면 X(Twitter)에서 @sudokaii에게 DM을 보내시거나 이메일을 보내 주세요.