{"id":51536673,"url":"https://github.com/jeiel85/retro-pixel-racer-android","last_synced_at":"2026-07-09T09:01:23.610Z","repository":{"id":361734637,"uuid":"1255142287","full_name":"jeiel85/retro-pixel-racer-android","owner":"jeiel85","description":"A nostalgic 2D pixel-art racing game featuring retro visual styles, 8-bit sound effects, track variety, car upgrades, simulated global multiplayer competitions, daily missions, and responsive performance.","archived":false,"fork":false,"pushed_at":"2026-06-01T02:25:55.000Z","size":13512,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-01T04:11:23.798Z","etag":null,"topics":["android","github-pages","jetpack-compose","kotlin","local-first","material3","pixel-art","play-store","racing-game","retro-game","retro-racer","sqlite"],"latest_commit_sha":null,"homepage":"https://jeiel85.github.io/retro-pixel-racer-android/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeiel85.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-31T13:10:48.000Z","updated_at":"2026-06-01T02:25:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jeiel85/retro-pixel-racer-android","commit_stats":null,"previous_names":["jeiel85/retro-pixel-racer-android"],"tags_count":2,"template":false,"template_full_name":"google-gemini/aistudio-repository-template","purl":"pkg:github/jeiel85/retro-pixel-racer-android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeiel85%2Fretro-pixel-racer-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeiel85%2Fretro-pixel-racer-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeiel85%2Fretro-pixel-racer-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeiel85%2Fretro-pixel-racer-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeiel85","download_url":"https://codeload.github.com/jeiel85/retro-pixel-racer-android/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeiel85%2Fretro-pixel-racer-android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35293217,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-09T02:00:07.329Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","github-pages","jetpack-compose","kotlin","local-first","material3","pixel-art","play-store","racing-game","retro-game","retro-racer","sqlite"],"created_at":"2026-07-09T09:01:23.030Z","updated_at":"2026-07-09T09:01:23.605Z","avatar_url":"https://github.com/jeiel85.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"100%\" alt=\"Retro Pixel Racer Banner\" src=\"store-graphics/play-console-current/feature_graphic_1024.png\" /\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \n  # 🏎️ Retro Pixel Racer\n  \n  [![Build Status](https://img.shields.io/badge/Build-Success-brightgreen.svg?style=for-the-badge\u0026logo=android)](https://github.com/jeiel85/retro-pixel-racer-android)\n  [![Platform](https://img.shields.io/badge/Platform-Android%208.0%20(API%2024)%2B-orange.svg?style=for-the-badge\u0026logo=android)](https://developer.android.com)\n  [![Pages](https://img.shields.io/badge/Pages-Active-blue.svg?style=for-the-badge\u0026logo=github)](https://jeiel85.github.io/retro-pixel-racer-android/)\n  [![License](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](https://github.com/jeiel85/retro-pixel-racer-android/blob/main/LICENSE)\n  \n\u003c/div\u003e\n\n---\n\n**Retro Pixel Racer**는 80년대 고전 아케이드의 강렬한 레이싱 재미를 안드로이드 모바일 환경에서 현대적인 Jetpack Compose 기술로 우아하게 재해석한 2D 픽셀 아트 레이싱 게임입니다. \n\n화려한 네온 신스웨이브 비주얼 필터와 기기 내부 오디오 버퍼로 직접 주파수를 합성하는 **8비트 사운드트랙 제너레이터**, 다채로운 차량 업그레이드 모듈, 그리고 박진감 넘치는 가상 글로벌 멀티플레이 모드로 질주의 아드레날린을 느껴보세요!\n\n\u003e 🌐 **공식 웹 페이지**: [https://jeiel85.github.io/retro-pixel-racer-android/](https://jeiel85.github.io/retro-pixel-racer-android/)  \n\u003e 브라우저에서 직접 키보드와 터치로 플레이 가능한 **인터랙티브 3D 캔버스 레이싱 미니게임**과 플레이 스토어 심사용 개인정보처리방침을 확인하실 수 있습니다.\n\n---\n\n## 🕹️ 핵심 플레이 모듈\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\"\u003e\n      \u003ch3\u003e🏎️ 차고지 \u0026 커스텀 차량 튜닝\u003c/h3\u003e\n      \u003cp\u003eClassic Red, Vortex Blue, Cyber Green 등 고유 외형을 지닌 차량들을 차고지(Garage)에서 선택하고 코인을 소모하여 성능을 업그레이드할 수 있습니다.\u003c/p\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003cstrong\u003eENGINE:\u003c/strong\u003e 가속 속도 인자 증강\u003c/li\u003e\n        \u003cli\u003e\u003cstrong\u003eHANDLING:\u003c/strong\u003e 좌우 조향 물리 팩터 강화\u003c/li\u003e\n        \u003cli\u003e\u003cstrong\u003eSPEED:\u003c/strong\u003e 차량의 절대 한계 최고 속도 돌파\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\"\u003e\n      \u003ch3\u003e🎵 실시간 8비트 사운드 신시사이저\u003c/h3\u003e\n      \u003cp\u003e본 게임은 용량을 차지하는 외부 오디오 에셋 파일을 사용하지 않습니다! 안드로이드 \u003ccode\u003eAudioTrack\u003c/code\u003e을 통해 정밀 \u003cstrong\u003esaw/square 파형 주파수를 실시간 합성\u003c/strong\u003e하여 레트로 엔진 굉음과 효과음을 생생하게 절차적으로 출력합니다.\u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\"\u003e\n      \u003ch3\u003e🏆 글로벌 리더보드 \u0026 매치메이킹\u003c/h3\u003e\n      \u003cp\u003e초기 Green Valley 숲길부터 Pixel Neon Grid 등의 고난이도 코스들을 잠금 해제해 나가며, 가상 글로벌 플레이어들과 기록 경주를 하거나 멀티플레이 로비에서 실시간 매치 듀얼을 펼칩니다.\u003c/p\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\"\u003e\n      \u003ch3\u003e📅 일일 스페셜 임무 \u0026 Room DB\u003c/h3\u003e\n      \u003cp\u003e매일 새롭게 갱신되는 4종의 스페셜 미션을 완수하여 업그레이드용 골드를 수집하세요. 모든 게임 정보 및 플레이어 설정 정보는 로컬 Room Database에 완벽히 오프라인 샌드박스로 안전하게 기록됩니다.\u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 🏗️ 시스템 아키텍처 흐름도\n\n```mermaid\ngraph TD\n    A[MainActivity] --\u003e|Edge-to-Edge \u0026 Crossfade| B(UI Screens Layer)\n    B --\u003e|User Inputs / Actions| C[GameViewModel]\n    C --\u003e|Synthesizes Saw/Square Wave| D[RetroSoundManager]\n    C --\u003e|Database Observables| E[GameRepository]\n    E --\u003e|Persistent Querying| F[GameDao]\n    F --\u003e|SQLite Transactions| G[(Room Database)]\n```\n\n---\n\n## 🚀 빠른 시작 가이드 (Quick Start)\n\n### 1. 개발 및 빌드 환경 요구사항\n* **Android Studio**: Ladybug (2024.2.1) 이상 권장\n* **JDK**: Version 17 이상\n* **Android SDK**: Compile SDK 36 (API 36), Min SDK 24 이상\n\n### 2. 로컬 빌드 및 컴파일 방법\n프로젝트 저장소를 로컬 컴퓨터로 클론한 후, 다음 터미널 명령어들을 활용해 빌드와 컴파일을 진행할 수 있습니다.\n\n```bash\n# 1. 저장소 클론\ngit clone https://github.com/jeiel85/retro-pixel-racer-android.git\ncd retro-pixel-racer-android\n\n# 2. 로컬 환경 변수 설정\n# 프로젝트 루트 디렉토리에 .env 파일을 생성하고 API 키를 설정합니다 (필요 시)\necho \"GEMINI_API_KEY=your_gemini_api_key\" \u003e .env\n\n# 3. Kotlin 소스코드 점검 및 컴파일\n./gradlew compileDebugKotlin\n\n# 4. 단위 테스트 실행\n./gradlew test\n\n# 5. 디버그용 APK 생성\n./gradlew assembleDebug\n```\n\n---\n\n## 📦 구글 플레이 릴리즈 배포 태스크\n\n본 프로젝트에는 플레이 스토어 배포본 생성을 완벽히 자동화하기 위해 **커스텀 Gradle 태스크**가 구축되어 있습니다.\n\n```bash\n# 플레이 스토어 배포용 Signed AAB 빌드 및 데스크톱 배포 자동화 실행\n./gradlew :app:exportReleaseToDesktop\n```\n\n### 💎 배포 태스크 동작 원리\n1. **R8 최적화 컴파일**: 릴리즈 최적화와 난독화 코드를 R8 엔진을 통해 컴파일하여 바이너리 용량을 50% 이상 극도로 축소합니다.\n2. **배포 서명 연동**: 로컬 `debug.keystore` 또는 환경 변수 기반 릴리즈 서명키를 바이너리에 탑재합니다.\n3. **데스크톱 배포본 내보내기**: 빌드가 완료되면 사용자 바탕화면에 **`Build` 폴더(`C:\\Users\\jeiel\\Desktop\\Build`)**를 생성하고, 그 안에 아래 두 에셋을 단일 폴더로 묶어 깔끔하게 내보냅니다.\n   * `RetroPixelRacer-v{versionName}-vc{versionCode}.aab` (심사용 AAB 번들)\n   * `RetroPixelRacer-v{versionName}-vc{versionCode}-release-notes.txt` (BCP-47 형식 한글 `\u003cko-KR\u003e` 및 영문 `\u003cen-US\u003e` 통합 출시 노트)\n\n---\n\n## 🔒 개인정보 처리 개요 (Privacy Policy)\n**Retro Pixel Racer**는 완전한 **로컬-퍼스트(Local-First) 오프라인 모바일 게임**입니다. 어떠한 네트워크 위치 정보 수집, 유저 트래킹, 제3자 분석 SDK 모듈도 포함되어 있지 않으며, 기기 내부 샌드박스 보안 규칙을 준수합니다. 상세 내용은 [Privacy Policy](https://jeiel85.github.io/retro-pixel-racer-android/privacy.html)를 참고해 주세요.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeiel85%2Fretro-pixel-racer-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeiel85%2Fretro-pixel-racer-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeiel85%2Fretro-pixel-racer-android/lists"}