Outlayr는 문장으로 입력하거나 말하고 영수증을 스캔해 지출을 기록하는 오픈소스 모바일 가계부·예산·구독 추적 앱이다. 거래 내역은 휴대전화에 저장되며, 로그인·동기화·서버 기능은 선택 사항이다. App Store와 Google Play에서 받을 수 있다.

주요 기능으로는 카테고리별 또는 전체 예산 설정, 이월과 월말 예상 지출 확인, 저축 목표·계좌·이체 관리가 있다. 165개 통화를 지원하고 구매 당일 환율로 환산한다. 구독과 급여를 자동 기록하고 결제 전 알림을 보내며, 인사이트·홈 화면 및 잠금 화면 위젯·Face ID 잠금·CSV 가져오기와 내보내기도 제공한다. 오프라인에서 사용할 수 있고 영어·스페인어·포르투갈어·프랑스어를 지원한다. 자세한 내용은 Outlayr 저장소와 tryoutlayr.com에서 확인할 수 있다.

설치와 실행

개발 환경에는 Node 24와 pnpm 관리 및 작업 실행에 사용하는 Vite+(vp)가 필요하다.

sh
curl -fsSL https://vite.plus | bash

앱 아이콘은 유료 비공개 레지스트리인 Hugeicons Pro에서 제공한다. 라이선스가 있다면 토큰을 저장소의 .npmrc가 아닌 사용자 전역 설정에 넣고 설치한다.

sh
vp pm config set --global "//npm.hugeicons.com/:_authToken" "<token>"
vp install

iOS 시뮬레이터나 Android 에뮬레이터에서 실행할 수 있다.

sh
vp run --filter @outlayr/native ios
vp run --filter @outlayr/native android

백엔드 없이도 앱을 실행할 수 있다. 동기화·로그인·환율 기능을 개발하려면 로컬 Convex 배포 환경을 시작하고 URL을 apps/native/.env에 넣어야 한다. 필요한 변수는 apps/native/.env.schema에 정리돼 있다.

sh
vp run dev:setup
vp run dev:server

Hugeicons Pro 라이선스가 없어도 무료 아이콘 세트를 사용해 앱을 실행할 수 있다. 이 경우 무료 세트에 없는 아이콘은 점선 원으로 표시된다.

sh
vp install -- '--config.minimum-release-age-exclude=@hugeicons-pro/*'
OUTLAYR_FREE_ICONS=1 vp run --filter @outlayr/native ios
OUTLAYR_FREE_ICONS=1 vp run --filter @outlayr/native android

타입 검사와 일부 테스트 모음, gen:icons에는 Pro 패키지가 필요하다. 저장소는 GPL-3.0 라이선스이며, packages/backend는 AGPL-3.0, apps/native/modules/glow는 MIT 라이선스 모듈을 포함한다. 앱의 apps/native는 라파엘 소(Rafael Soh)와 기여자들이 만든 Dime을 수정한 버전에서 시작했다. 구조와 실행 방법은 문서, 라이선스 세부 정보는 저장소의 라이선스 안내에서 확인할 수 있다. SwiftUI 시절의 NumberFlow 패키지는 danestves/numberflow 저장소로 옮겨졌다.