Skip to content

🐱 Smart alarm app with batch scheduling, weekend exclusions, templates, and a cute cat character. Built with Expo (React Native) + TypeScript.

License

Notifications You must be signed in to change notification settings

imshota1009/nyarm-android

🐱 Nyarm - Smart Alarm App

A smart alarm app with batch scheduling and a cute cat character.

Nyarm Banner

✨ Features

  • πŸ“… Range Selection - Select date ranges on calendar and set alarms at once
  • 🚫 Exclusions - Automatically exclude weekends or holidays
  • πŸ“‹ Templates - Save and reuse your favorite alarm settings
  • 🐱 Cat Character - Cute animated cat cheers you on!
  • πŸ”” Push Notifications - Get notified right on time

πŸ“± Installation

Option 1: Download APK (Recommended)

  1. Go to Releases page
  2. Download the latest nyarm-vX.X.X.apk
  3. Install on your Android device

⚠️ You may need to enable "Install from unknown sources" on your device

Option 2: Try with Expo Go

  1. Install Expo Go on your phone
  2. Clone this repository
  3. Run npm install
  4. Run npx expo start
  5. Scan the QR code with Expo Go

πŸ› οΈ Development Setup

# Clone the repository
git clone https://github.com/imshota1009/nyarm-android.git
cd nyarm-android

# Install dependencies
npm install

# Start development server
npx expo start

πŸ“¦ Building APK

Local Build

# Install EAS CLI
npm install -g eas-cli

# Login to EAS
eas login

# Build development APK
eas build --platform android --profile development

GitHub Actions

APK is automatically built when a new Release is created.

πŸ“ Project Structure

nyarm-android/
β”œβ”€β”€ App.tsx              # Main app
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/      # UI components
β”‚   β”‚   β”œβ”€β”€ Calendar.tsx
β”‚   β”‚   β”œβ”€β”€ CatCharacter.tsx
β”‚   β”‚   └── AlarmModal.tsx
β”‚   β”œβ”€β”€ hooks/           # Custom hooks
β”‚   β”‚   β”œβ”€β”€ useAlarms.ts
β”‚   β”‚   β”œβ”€β”€ useTemplates.ts
β”‚   β”‚   └── useNotifications.ts
β”‚   β”œβ”€β”€ utils/           # Utilities
β”‚   β”‚   β”œβ”€β”€ storage.ts
β”‚   β”‚   └── date.ts
β”‚   └── types/           # Type definitions
β”‚       └── index.ts
β”œβ”€β”€ assets/              # Images
β”œβ”€β”€ app.json             # Expo config
└── package.json

🎨 Tech Stack

  • Expo (React Native)
  • TypeScript
  • expo-notifications - Push notifications
  • AsyncStorage - Data persistence

πŸ“„ License

MIT License


🐱 "Thanks for using Nyarm, nya~!"

About

🐱 Smart alarm app with batch scheduling, weekend exclusions, templates, and a cute cat character. Built with Expo (React Native) + TypeScript.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors