https://github.com/mrdeveloperjis/calendar-androidapp

A minimal, swipeable Android calendar built with Jetpack Compose and Material 3. Clean monthly view, animated transitions, and tap-to-jump year/month pickers.
https://github.com/mrdeveloperjis/calendar-androidapp

android-app android-studio calendar kotlin

Last synced: 2 days ago
JSON representation

A minimal, swipeable Android calendar built with Jetpack Compose and Material 3. Clean monthly view, animated transitions, and tap-to-jump year/month pickers.

Host: GitHub
URL: https://github.com/mrdeveloperjis/calendar-androidapp
Owner: MrDeveloperJIS
License: mit
Created: 2026-06-24T07:00:38.000Z (13 days ago)
Default Branch: main
Last Pushed: 2026-06-28T06:18:43.000Z (9 days ago)
Last Synced: 2026-06-28T08:10:38.567Z (9 days ago)
Topics: android-app, android-studio, calendar, kotlin
Language: Kotlin
Homepage:
Size: 210 KB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# 📅 Calendar — Android App

A clean, minimal calendar app for Android built entirely with **Jetpack Compose** and **Material 3**. No third-party dependencies, no bloat — just a fast, native calendar experience.

---

## ✨ Features

- **Monthly calendar grid** — clean 7-column layout with a Saturday-first week start
- **Swipe navigation** — swipe left/right anywhere on the screen to move between months
- **Animated transitions** — smooth slide animations when changing months, with correct directional logic
- **Tap to navigate** — tap the month or year in the header to jump directly via picker dialogs
- **Year picker** — scrollable grid covering 1991–2050, auto-scrolled to the current year
- **Month picker** — 3-column grid for quick month selection
- **Today card** — pinned bottom card showing today's full date; tap it to jump back to the current month
- **Today & selected day indicators** — today gets an outline ring; selected date gets a filled circle
- **Edge-to-edge UI** — full-screen layout with no wasted space
- **Material 3 theming** — follows system color scheme (light/dark mode)

---

## 🛠 Tech Stack

| Layer | Technology |
|---|---|
| Language | Kotlin |
| UI | Jetpack Compose |
| Design system | Material 3 |
| Date/time | `java.time` (LocalDate, YearMonth) |
| Architecture | Single-Activity, Composable functions |
| Min SDK | 35 (Android 15) |
| Target SDK | 36 |

---

## 📁 Project Structure

```
app/src/main/java/com/mrjis/calendar/
│
├── MainActivity.kt # Entry point; hosts CalendarApp composable
│
└── ui/theme/
├── Color.kt # App color palette
├── Theme.kt # MaterialTheme setup
└── Type.kt # Typography definitions
```

**Key composables inside `MainActivity.kt`:**

- `CalendarApp` — root composable; manages state (current month, selected date, slide direction)
- `CalendarHeader` — animated month/year label with tap-to-pick support
- `WeekdayHeader` — static Sat–Fri day-of-week labels
- `CalendarGrid` — `LazyVerticalGrid` rendering all day cells for a given month
- `DayCell` — individual day tile with selected/today visual states
- `TodayDateCard` — bottom card displaying today's full date and acting as a reset button
- `YearPickerDialog` — scrollable year selection dialog
- `MonthPickerDialog` — 3-column month selection dialog

---

## 🚀 Getting Started

### Prerequisites

- Android Studio Hedgehog or later
- Android SDK 35+
- Kotlin 2.x

### Build & Run

```bash
git clone https://github.com/MrDeveloperJIS/Calendar-AndroidApp.git
cd Calendar-AndroidApp
```

Open the project in Android Studio, wait for Gradle sync, then run on a device or emulator running **Android 15 (API 35)** or higher.

---

## 📱 Screenshots