Merge pull request #5 from danialkhilji/develop

Release v1.3: calendar, birthdays, reminders, weather animations, mobile app

Author: danialkhilji

CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## v1.3
+
+### New Features
+- Dashboard calendar with expandable modal, month/year dropdowns, swipe navigation, and date selection
+- Task reminders with date/time picker and overdue highlighting on dashboard
+- Recurring tasks (daily/weekly/monthly) with automatic reset via APScheduler
+- Calendar-task integration — select any date to see its tasks
+- Birthday tracking via calendar — add birthdays for anyone, yearly repeat, upcoming birthdays card on dashboard
+- Calendar as core system — unified /api/v1/calendar/by-date endpoint returning tasks and birthdays
+- Animated weather card backgrounds (sunny, cloudy, rainy, snowy, stormy, windy) with CSS keyframes
+- Enhanced weather data — feels like, rain chance, daily high/low from Open-Meteo
+- Mobile app via PWA + Tailscale — responsive UI, installable on phone, remote access
+- Custom app icon (Figma-designed HomeOS icon)
+- Quick-add shopping items with emoji buttons and custom items in Settings
+
+### Improvements
+- Removed dark mode (unused by family)
+- Auto-scroll focused input into view when keyboard opens in modals
+- Weather card vertically and horizontally centred
+- Responsive font sizes (14px phone, 18px tablet)
+- Calendar grid stays fixed while tasks/birthdays scroll independently
+- Add Birthday and Today buttons always visible at bottom of calendar
+
+### Infrastructure
+- Moved birthdays module into calendar module
+- Moved calendar components to features/calendar/ folder
+- Moved project docs to private KnowledgeBase repo
+- 119 backend tests total
+
+---
+
 ## v1.2
 
 ### New Features

README.md

@@ -127,6 +127,47 @@ To verify Docker is running after a restart:
 sudo systemctl status docker
 ```
 
+### Remote Access with Tailscale
+
+Access HomeOS from your phone outside your home WiFi using Tailscale (free VPN).
+
+**On the Linux laptop (HomeOS server):**
+
+```bash
+curl -fsSL https://tailscale.com/install.sh | sh
+sudo tailscale up
+```
+
+Note the Tailscale IP shown (e.g. `100.x.x.x`).
+
+**On your phone:**
+
+1. Install Tailscale from App Store (iPhone) or Play Store (Android)
+2. Sign in with the same account used on the Linux laptop
+3. Open `http://100.x.x.x` in your phone browser (use the Tailscale IP from above)
+
+Tailscale runs in the background — once set up, your phone can reach HomeOS from anywhere without opening ports or exposing your home network.
+
+### Install on Phone (Add to Home Screen)
+
+HomeOS is a PWA — it can be installed on your phone's home screen like a native app.
+
+**iPhone (Safari):**
+
+1. Open HomeOS in Safari (use your home WiFi IP or Tailscale IP)
+2. Tap the Share button (square with arrow)
+3. Scroll down and tap "Add to Home Screen"
+4. Tap "Add"
+
+**Android (Chrome):**
+
+1. Open HomeOS in Chrome
+2. Tap the three-dot menu
+3. Tap "Add to Home screen" or "Install app"
+4. Tap "Add"
+
+The app opens fullscreen without a browser address bar, with the HomeOS icon on your home screen.
+
 ### Useful commands
 
 ```bash
@@ -219,5 +260,6 @@ HomeOS/
 │       ├── layouts/   # App shell and navigation
 │       ├── stores/    # Zustand state management
 │       └── types/     # Shared TypeScript types
-└── docs/             # Vision, roadmap, engineering guidelines
+├── scripts/          # Backup and utility scripts
+└── CHANGELOG.md      # Release history
 ```

backend/app/api/v1/router.py

@@ -8,13 +8,19 @@
 from app.modules.weather.router import router as weather_router
 from app.modules.prayer.router import router as prayer_router
 from app.modules.shopping.store_router import router as store_router
+from app.modules.shopping.quick_add_router import router as quick_add_router
+from app.modules.calendar.birthday_router import router as birthdays_router
+from app.modules.calendar.calendar_router import router as calendar_router
 
 v1_router = APIRouter()
 v1_router.include_router(health_router)
 v1_router.include_router(members_router)
 v1_router.include_router(tasks_router)
 v1_router.include_router(shopping_router)
 v1_router.include_router(store_router)
+v1_router.include_router(quick_add_router)
 v1_router.include_router(notes_router)
 v1_router.include_router(weather_router)
 v1_router.include_router(prayer_router)
+v1_router.include_router(birthdays_router)
+v1_router.include_router(calendar_router)

backend/app/core/config.py

@@ -14,7 +14,7 @@ class Settings(BaseSettings):
 
     APP_NAME: str = "HomeOS"
     DEBUG: bool = True
-    VERSION: str = "1.2"
+    VERSION: str = "1.3"
 
     DATABASE_URL: str = f"sqlite+aiosqlite:///{BASE_DIR / 'homeos.db'}"
 

backend/app/core/scheduler.py

@@ -19,6 +19,19 @@ async def run_prayer_refresh() -> None:
         logger.exception("Scheduled prayer times refresh failed")
 
 
+async def run_recurrence_reset() -> None:
+    from app.modules.tasks.recurrence import reset_recurring_tasks
+
+    logger.info("Scheduled recurring task reset triggered")
+    async with async_session_factory() as session:
+        try:
+            await reset_recurring_tasks(session)
+            await session.commit()
+        except Exception:
+            await session.rollback()
+            logger.exception("Scheduled recurring task reset failed")
+
+
 async def run_rotation() -> None:
     from app.modules.tasks.rotation import rotate_tasks
 
@@ -39,14 +52,20 @@ def setup_scheduler() -> None:
         id="weekly_task_rotation",
         replace_existing=True,
     )
+    scheduler.add_job(
+        run_recurrence_reset,
+        trigger=CronTrigger(hour=0, minute=1),
+        id="daily_recurrence_reset",
+        replace_existing=True,
+    )
     scheduler.add_job(
         run_prayer_refresh,
         trigger=CronTrigger(hour=1, minute=0),
         id="daily_prayer_refresh",
         replace_existing=True,
     )
     scheduler.start()
-    logger.info("Scheduler started: task rotation every Monday at midnight, prayer times refresh daily at 1am")
+    logger.info("Scheduler started: recurrence reset daily at 00:01, task rotation every Monday at midnight, prayer times refresh daily at 1am")
 
 
 def shutdown_scheduler() -> None:

backend/app/modules/calendar/__init__.py

@@ -0,0 +1,3 @@
+from app.modules.calendar.birthday_models import Birthday
+
+__all__ = ["Birthday"]

backend/app/modules/calendar/birthday_models.py

@@ -0,0 +1,16 @@
+from datetime import datetime
+
+from sqlalchemy import String, Integer, DateTime, func
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.core.database import Base
+
+
+class Birthday(Base):
+    __tablename__ = "birthdays"
+
+    id: Mapped[int] = mapped_column(primary_key=True, autoincrement=True)
+    name: Mapped[str] = mapped_column(String(200), nullable=False)
+    month: Mapped[int] = mapped_column(Integer, nullable=False)
+    day: Mapped[int] = mapped_column(Integer, nullable=False)
+    created_at: Mapped[datetime] = mapped_column(DateTime, server_default=func.now())

backend/app/modules/calendar/birthday_router.py

@@ -0,0 +1,41 @@
+from fastapi import APIRouter, Depends, Query
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.core.database import get_db
+from app.modules.calendar.birthday_schemas import BirthdayCreate, BirthdayResponse, UpcomingBirthdayResponse
+from app.modules.calendar import birthday_service as service
+
+router = APIRouter(prefix="/birthdays", tags=["birthdays"])
+
+
+@router.get("", response_model=list[BirthdayResponse])
+async def list_birthdays(db: AsyncSession = Depends(get_db)):
+    return await service.get_all_birthdays(db)
+
+
+@router.get("/upcoming", response_model=list[UpcomingBirthdayResponse])
+async def upcoming_birthdays(
+    days: int = Query(7, ge=1, le=365),
+    db: AsyncSession = Depends(get_db),
+):
+    return await service.get_upcoming_birthdays(db, days)
+
+
+@router.get("/by-date", response_model=list[BirthdayResponse])
+async def birthdays_by_date(
+    month: int = Query(..., ge=1, le=12),
+    day: int = Query(..., ge=1, le=31),
+    db: AsyncSession = Depends(get_db),
+):
+    return await service.get_birthdays_by_date(db, month, day)
+
+
+@router.post("", response_model=BirthdayResponse, status_code=201)
+async def create_birthday(data: BirthdayCreate, db: AsyncSession = Depends(get_db)):
+    return await service.create_birthday(db, data)
+
+
+@router.delete("/{birthday_id}")
+async def delete_birthday(birthday_id: int, db: AsyncSession = Depends(get_db)):
+    await service.delete_birthday(db, birthday_id)
+    return {"message": "Birthday deleted"}

backend/app/modules/calendar/birthday_schemas.py

@@ -0,0 +1,29 @@
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+
+class BirthdayCreate(BaseModel):
+    name: str = Field(min_length=1, max_length=200)
+    month: int = Field(ge=1, le=12)
+    day: int = Field(ge=1, le=31)
+
+
+class BirthdayResponse(BaseModel):
+    id: int
+    name: str
+    month: int
+    day: int
+    created_at: datetime
+
+    model_config = {"from_attributes": True}
+
+
+class UpcomingBirthdayResponse(BaseModel):
+    id: int
+    name: str
+    month: int
+    day: int
+    days_until: int
+
+    model_config = {"from_attributes": True}

backend/app/modules/calendar/birthday_service.py

@@ -0,0 +1,65 @@
+from datetime import date
+
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.core.exceptions import NotFoundError
+from app.modules.calendar.birthday_models import Birthday
+from app.modules.calendar.birthday_schemas import BirthdayCreate, UpcomingBirthdayResponse
+
+
+async def get_all_birthdays(db: AsyncSession) -> list[Birthday]:
+    result = await db.execute(select(Birthday).order_by(Birthday.month, Birthday.day))
+    return list(result.scalars().all())
+
+
+async def get_birthdays_by_date(db: AsyncSession, month: int, day: int) -> list[Birthday]:
+    result = await db.execute(
+        select(Birthday).where(Birthday.month == month, Birthday.day == day)
+    )
+    return list(result.scalars().all())
+
+
+async def get_upcoming_birthdays(db: AsyncSession, days: int = 7) -> list[UpcomingBirthdayResponse]:
+    today = date.today()
+    result = await db.execute(select(Birthday))
+    all_birthdays = list(result.scalars().all())
+
+    upcoming = []
+    for bday in all_birthdays:
+        try:
+            this_year = date(today.year, bday.month, bday.day)
+        except ValueError:
+            continue
+
+        if this_year < today:
+            this_year = date(today.year + 1, bday.month, bday.day)
+
+        days_until = (this_year - today).days
+        if 0 <= days_until <= days:
+            upcoming.append(UpcomingBirthdayResponse(
+                id=bday.id,
+                name=bday.name,
+                month=bday.month,
+                day=bday.day,
+                days_until=days_until,
+            ))
+
+    upcoming.sort(key=lambda b: b.days_until)
+    return upcoming
+
+
+async def create_birthday(db: AsyncSession, data: BirthdayCreate) -> Birthday:
+    birthday = Birthday(name=data.name, month=data.month, day=data.day)
+    db.add(birthday)
+    await db.flush()
+    await db.refresh(birthday)
+    return birthday
+
+
+async def delete_birthday(db: AsyncSession, birthday_id: int) -> None:
+    result = await db.execute(select(Birthday).where(Birthday.id == birthday_id))
+    birthday = result.scalar_one_or_none()
+    if not birthday:
+        raise NotFoundError("Birthday", birthday_id)
+    await db.delete(birthday)