프로젝트 소개

fablab-tools는 Claude Code로 구축되고 GitHub Actions를 통해 게시되는 FabLab 503의 무료 오픈 소스 앱 및 유틸리티를 호스팅합니다. 주요 프로젝트는 VeloTrack입니다. VeloTrack — 오프라인 사이클링 지도 및 라이딩 기록기 (Android) - GPS만으로 작동하는 3D 코스-업 벡터 지도로, 라이딩 중 데이터 연결이 필요하지 않습니다. Protomaps planet 파일에서 선택한 반경(10km, 100km, 1000km, 프랑스와 같은 국가 또는 전 세계)에 따라 앱 내에서 지도 영역을 직접 다운로드할 수 있습니다. - 길이 제한 없는 라이딩 기록 기능을 제공하며, 출발 시 자동 시작, 정지 시 자동 일시 중지, GPX 내보내기 및 평생 통계 기능을 지원합니다. - 집, 직장 및 즐겨찾는 장소에 대한 직선 안내와 현재 위치한 거리 또는 공원의 이름을 제공합니다. - 시속 5km 이상에서 표시되는 최소한의 라이딩 모드, 일출 및 일몰에 따라 전환되는 주간/야간 테마, 그리고 OLED 친화적인 다크 스타일을 지원합니다. - 계정, 분석 도구, Google Play 서비스가 없으며, README에 따르면 배터리 수명을 위해 구축되었습니다. 설치: Releases 페이지(태그 `velotrack-latest`)에서 `velotrack-latest.apk`를 휴대폰으로 다운로드하여 실행하십시오. 더 자세한 가이드, 스크린샷, 설정 및 빌드 노트는 velotrack/README.md에서 확인할 수 있습니다. 저장소 구조 - `velotrack/` — Android 앱(Kotlin), 관련 도구 및 제3자 고지 사항. - `.github/workflows/` — 매 푸시마다 APK를 빌드, 테스트, 서명 및 게시하며 요청 시 지도 추출을 수행하는 CI. - `docs/superpowers/` — 각 기능 개발 단계 전에 작성된 디자인 브리프 및 계획. - `assets/icons3d/` — 일러스트레이션에 사용된 CC0 3D 아이콘 라이브러리(3dicons.co). - `skills/` — 프로젝트 구축 및 테스트 방법을 설명하는 Claude Code 스킬. 기여 방법: 이슈를 생성하거나 풀 리퀘스트(PR)를 보내주십시오. 빌드는 GitHub Actions에서만 실행되므로 Android Studio가 필요하지 않습니다. 브랜치를 푸시하고 워크플로우 로그를 확인하십시오. 포크(fork)를 통한 풀 리퀘스트는 릴리스 서명 키가 저장소 비밀값으로 관리되므로 디버그 서명된 APK를 생성합니다. 라이선스: MIT (LICENSE 참조). VeloTrack은 velotrack/THIRD_PARTY.md에 나열된 각자의 라이선스에 따라 제3자 구성 요소를 번들로 제공합니다. 지도 데이터는 © OpenStreetMap 기여자(ODbL)에게 있습니다.