tech08mag/carry-your-live
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 19 Wiki Activity

Merge pull request 'Fixed the artifact path from outputs/release/ to outputs/apk/release/ in the workflow' (#32) from dev into main
Build and Release APK / build (push) Failing after 20m49s
Details
Build and Release APK / release (push) Skipped
Details

Browse Source 
Reviewed-on: #32
This commit was merged in pull request #32.
This commit is contained in:
tech08mag
2026-08-28 20:40:49 +00:00
parent c787b87cc5 4c6adc7117
commit beb6cc5715
2 changed files with 497 additions and 116 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.gitea/workflows/release.yml
+1 -1
View File
@@ -83,7 +83,7 @@ jobs:
uses: actions/upload-artifact@v4 uses: actions/upload-artifact@v4
with: with:
name: carry-your-live-release name: carry-your-live-release
path: carry-your-live/android/app/build/outputs/release/app-release.apk path: carry-your-live/android/app/build/outputs/apk/release/app-release.apk
release: release:
needs: build needs: build
README.md
+496 -115
View File
@@ -1,15 +1,40 @@
# Carry Your Live - Mobile To-Do & Calendar App # Carry Your Live - Mobile To-Do & Calendar App
A minimalist, offline-first task management app built with Expo, React Native, and WatermelonDB. Features three primary screens: To-Do List, Add New Task, and Calendar with bottom navigation. A minimalist, offline-first task management app built with Expo, React Native, and WatermelonDB. Features multiple screens with bottom navigation, social features, and a full-featured backend API.
## 📝 Recent Fixes ## 📝 Recent Progress (v1.1.0 - Unreleased)
- **ListItem component**: Fixed empty component - now properly renders list items with title, subtitle, icons, and swipe actions ### Added
- **Subtask drag-and-drop**: Added `parentSubtaskId` type support for proper subtask reparenting - **Friends feature**: Friend requests, accept/decline/remove, user search, full backend routes
- **Task drag sorting**: Added task drag-and-drop reordering functionality with visual drop indicators - **Assignee field on tasks**: Schema v7, model, types, forms, sync, task actions
- **iCal import**: Fixed import functionality - replaced invalid `splice()` with proper `create()` calls and fixed date type handling - **AssigneeSelector component** and assignee display in TaskItem
- **Settings context**: Added `accentOpacity` and `setAccentOpacity` to the Settings context - **QuickAddBar** on tasks overview (copied from calendar)
- **Tag inheritance**: Subtasks no longer automatically inherit parent task tags when converting tasks to subtasks - **Backend**: Mounted friends route, added assigneeId to task validation and sync
### Changed
- Due date prefilled from Calendar "+" button
- 12-hour time formatting across task rows and pickers
- Calendar strip scrolls to selected day when navigating months
- Calendar completion toggle now handles repeating tasks and reminders
- Task color strips now use the task's category color
### Fixed
- WheelTimePicker FlatList scroll clamping - all hours (0-23) and minutes (0-59) reachable
- WheelTimePicker selection highlight background connecting selected item with colon separator
- WheelTimePicker number alignment in scroll list
- Tasks without a due date no longer get overdue styling
- `useOverdueTasks` infinite re-subscription loop (Date.now in effect deps)
- Web/Android crashes from decorator transform ordering (babel config)
- FormButtons crash outside FormProvider; Cancel navigation fallback
- Task repeat settings, reminders and series info now sync to backend
### Removed
- Task color picker (task color now comes from its category)
- Drag lift popup from TaskItem (scale + shadow on drag)
- Checkbox from task items
- Selection bar overlapping QuickAddBar on tasks overview
---
## Features ## Features
@@ -17,97 +42,145 @@ A minimalist, offline-first task management app built with Expo, React Native, a
- **Offline-First Architecture**: Full CRUD operations work offline with WatermelonDB + SQLite - **Offline-First Architecture**: Full CRUD operations work offline with WatermelonDB + SQLite
- **Auto-Sync**: Background synchronization with custom Postgres API when online - **Auto-Sync**: Background synchronization with custom Postgres API when online
- **Cross-Platform**: iOS, Android, and Web from single codebase - **Cross-Platform**: iOS, Android, and Web from single codebase
- **Desktop Support**: Electron wrapper for desktop app distribution
### Screens ### Screens
#### 1. To-Do List Screen #### 1. Tasks Screen (To-Do List)
- **Header**: App logo + "TODO" title with rounded corners - **Header**: App logo + "TODO" title with rounded corners
- **Category Filter**: Horizontal scrollable chips (Work, Personal, School, Shopping, Health, Finance, All) - **Category Filter**: Horizontal scrollable chips (Work, Personal, School, Shopping, Health, Finance, All)
- Single selection with visual feedback (thicker border, shadow, scale animation) - Single selection with visual feedback (thicker border, shadow, scale animation)
- Instant task filtering - Instant task filtering
- **Task List**: Vertical scrolling with: - **QuickAddBar**: Quick task creation from list view
- Checkbox (empty/checked states with animation) - **Task List**: Virtualized FlatList with sections (Pending/Completed)
- Task title (truncated with ellipsis) - Task title (truncated with ellipsis)
- Three-dot overflow menu (Edit, Delete, Duplicate, Mark Complete, Change Category, Change Priority) - Three-dot overflow menu (Edit, Delete, Duplicate, Mark Complete, Change Category, Change Priority)
- Priority badges with colors - Priority badges with colors
- Due date/time with overdue/due-today highlighting - Due date/time with overdue/due-today highlighting
- Completed section (collapsible) - Category color indicator strip
- **Floating Action Button**: Bottom-right, opens Add Task screen with press animation - Assignee display
- Swipe actions (left: delete, right: complete)
- Drag-to-reorder with visual drop indicators
- Long press → Selection mode (multi-delete, multi-complete, change category/priority)
- **Floating Action Button**: Bottom-right, opens Add Task screen
#### 2. Add New Task Screen #### 2. Calendar Screen
- **Date Strip**: Horizontal scrollable days of current month
- Current day highlighted, scrolls to selected day on month change
- **Month Label**: Centered (e.g., "JAN 2026")
- **QuickAddBar**: Quick task creation for selected date
- **Task List**: Tasks for selected day with category color, title, time, completion status
- **Analog Clock Widget**: Decorative analog clock display
- **Empty State**: "No tasks scheduled."
- **Day View**: Detailed view for selected day (pushes to stack)
#### 3. Stats Screen
- Client-side statistics (`useStats` hook)
- Task completion metrics
- Category and priority breakdowns
#### 4. Settings Screen
- **Account**: Login/Register/Sign Out (SyncModal)
- **Server URL Override**: Custom API endpoint configuration
- **Appearance**: Accent color picker (dark mode toggle planned)
- **Task Defaults**: Default category, sort order (Date, Priority, Alphabetically, Creation Date), show completed toggle
- **Calendar**: Days ahead to display
- **Reminders**: Global reminder preference (stored, wiring in progress)
- **Notifications**: Toggle (stored, wiring in progress)
- **Legal**: Privacy Policy, Terms of Service
- **About**: Version info
#### 5. Add New Task Screen
- **Category Selector**: Horizontal row of colored circles (required) - **Category Selector**: Horizontal row of colored circles (required)
- **Task Name**: Single-line input, 100 char max (required) - **Task Name**: Single-line input, 100 char max (required)
- **Subtasks**: Unlimited, add/remove individually - **Subtasks**: Unlimited, add/remove individually, nested subtask support
- **Date & Time**: Date picker, time picker, calendar button - **Date & Time**: Date picker, time picker (WheelTimePicker), calendar button
- **Priority**: Dropdown (None, Low, Medium, High, Critical) with color indicators - **Priority**: Dropdown (None, Low, Medium, High, Critical) with color indicators
- **Repeat Profile**: Recurring task configuration
- **Reminder**: Reminder offset selector
- **Assignee**: Assign task to friend
- **Description**: Multi-line text area, 1000 char max - **Description**: Multi-line text area, 1000 char max
- **Bottom Actions**: Submit (primary) / Cancel (secondary) fixed buttons - **Bottom Actions**: Submit (primary) / Cancel (secondary) fixed buttons
#### 3. Calendar Screen #### 6. Task Detail Screen
- **Date Strip**: Horizontal scrollable days of current month - Full task view with all fields
- **Month Label**: Centered (e.g., "JAN 2026") - Subtask management (add, complete, reorder, convert to task)
- **Task List**: Tasks for selected day with category color, title, time, completion status - Edit functionality
- **Empty State**: "No tasks scheduled." - Repeat profile configuration
#### 4. Settings Screen #### 7. Subtask Detail Screen
- Dark Mode toggle - Nested subtask management
- Push Notifications toggle - Convert subtask ↔ task
- Reminder Preferences - Re-parent subtasks
- Default Category selector
- Sort Tasks By (Date, Priority, Alphabetically, Creation Date)
- Backup & Sync
- Version, Privacy Policy, Terms of Service
### Task States #### 8. Sync Modal
- **Pending**: Empty checkbox, normal text - Login/Register forms
- **Completed**: Checked checkbox, strikethrough, reduced opacity - Forgot/Reset password flow
- **Overdue**: Red due date, warning indicator - Server URL configuration
- **Due Today**: Blue highlight - Sync status display
- **High Priority**: Priority badge
### Interactions ### Task Features
- Tap task → Edit screen - **Nested Subtasks**: Unlimited depth, re-parenting, drag reorder
- Long press → Selection mode (multi-delete, multi-complete, change category/priority) - **Repeating Tasks**: Repeat profiles, series IDs, this/future/all delete scopes, undo-complete
- Swipe left → Delete - **Categories/Tags**: 6 default categories with colors, custom category editor
- Swipe right → Complete - **Priorities**: None, Low, Medium, High, Critical with color badges
- Pull down → Refresh - **Due Dates/Times**: With all-day option
- **Reminders**: Per-task reminder offsets
- **Assignees**: Assign tasks to friends
- **Overdue/Due Today**: Visual highlighting
### Social Features
- **Friends System**: Send/accept/decline/remove friend requests
- **User Search**: Find users by username/email
- **Task Assignment**: Assign tasks to friends (client-side, backend schema ready)
---
## Tech Stack ## Tech Stack
| Layer | Technology | | Layer | Technology |
|-------|------------| |-------|------------|
| Framework | Expo (React Native) | | Framework | Expo (React Native) / Expo Router v3 |
| Language | TypeScript | | Language | TypeScript (strict mode) |
| Navigation | Expo Router (file-based) | | Navigation | Expo Router (file-based) |
| Database | WatermelonDB + SQLite | | Database | WatermelonDB + SQLite (expo-sqlite) |
| State | WatermelonDB (reactive queries, no Redux needed) | | State | WatermelonDB reactive queries (no Redux) |
| Forms | React Hook Form + Zod validation | | Forms | React Hook Form + Zod validation |
| UI Components | React Native Paper + Custom SVG icons | | UI Components | React Native Paper + Custom components |
| Animations | React Native Reanimated | | Animations | React Native Reanimated v3 |
| Date/Time | @react-native-community/datetimepicker + date-fns | | Date/Time | @react-native-community/datetimepicker + date-fns + WheelTimePicker |
| Build | EAS Build / Gradle (local APK) | | Build | EAS Build / Gradle (local APK) / Electron Builder (desktop) |
| CI/CD | Gitea Actions (`.gitea/workflows/build-apk.yml`) | | CI/CD | Gitea Actions (`.gitea/workflows/build-apk.yml`) |
| Backend | Node.js + Express + TypeScript |
| Backend DB | PostgreSQL + Drizzle ORM |
| Auth | JWT (access + refresh tokens) |
| Validation | Zod (shared with frontend) |
---
## Project Structure ## Project Structure
``` ```
carry-your-live/ carry-your-live/
├── app/ ├── app/
│ ├── _layout.tsx # Root layout + DatabaseProvider │ ├── _layout.tsx # Root layout + DatabaseProvider + AuthProvider
│ ├── (tabs)/ │ ├── (tabs)/
│ │ ├── _layout.tsx # Bottom tab navigator │ │ ├── _layout.tsx # Bottom tab navigator
│ │ ├── index.tsx # Tasks screen │ │ ├── index.tsx # Tasks screen
│ │ ├── calendar.tsx # Calendar screen │ │ ├── calendar.tsx # Calendar screen
│ │ ├── stats.tsx # Stats screen
│ │ └── settings.tsx # Settings screen │ │ └── settings.tsx # Settings screen
│ └── add-task.tsx # Add Task screen │ ├── add-task.tsx # Add Task screen
│ ├── day-view.tsx # Calendar day detail
│ ├── task-detail.tsx # Task view/edit
│ └── subtask-detail.tsx # Subtask view/edit
├── src/ ├── src/
│ ├── components/ # Reusable UI components │ ├── components/ # Reusable UI components (30+)
│ │ ├── Header.tsx │ │ ├── Header.tsx
│ │ ├── CategoryFilter.tsx │ │ ├── CategoryFilter.tsx
│ │ ├── TaskList.tsx │ │ ├── TaskList.tsx
│ │ ├── TaskItem.tsx │ │ ├── TaskItem.tsx
│ │ ├── FloatingActionButton.tsx │ │ ├── FloatingActionButton.tsx
│ │ ├── TabBarIcon.tsx
│ │ ├── CategorySelector.tsx │ │ ├── CategorySelector.tsx
│ │ ├── TaskNameInput.tsx │ │ ├── TaskNameInput.tsx
│ │ ├── SubtasksSection.tsx │ │ ├── SubtasksSection.tsx
@@ -115,24 +188,102 @@ carry-your-live/
│ │ ├── PrioritySelector.tsx │ │ ├── PrioritySelector.tsx
│ │ ├── DescriptionInput.tsx │ │ ├── DescriptionInput.tsx
│ │ ├── FormButtons.tsx │ │ ├── FormButtons.tsx
│ │ └── ListItem.tsx │ │ ├── ListItem.tsx
│ │ ├── AnalogClock.tsx
│ │ ├── AssigneeSelector.tsx
│ │ ├── CategoryEditorModal.tsx
│ │ ├── ColorPickerInput.tsx
│ │ ├── ColorWheel.tsx
│ │ ├── DateTimeInput.tsx
│ │ ├── ForgotPasswordModal.tsx
│ │ ├── FriendsModal.tsx
│ │ ├── LegalModal.tsx
│ │ ├── OptionPickerModal.tsx
│ │ ├── QuickAddBar.tsx
│ │ ├── ReminderSelector.tsx
│ │ ├── RepeatSelector.tsx
│ │ ├── ServerUrlModal.tsx
│ │ ├── SubtaskItem.tsx
│ │ ├── SyncModal.tsx
│ │ ├── SyncStatus.tsx
│ │ ├── TabBarIcon.tsx
│ │ ├── TaskDeleteModal.tsx
│ │ ├── TaskOverflowMenu.tsx
│ │ ├── UpdateNotifier.tsx
│ │ └── WheelTimePicker.tsx
│ ├── constants/
│ │ └── index.ts # Categories, priorities, colors, reminder options
│ ├── database/ │ ├── database/
│ │ ├── schema.ts # WatermelonDB schema │ │ ├── schema.ts # WatermelonDB schema (v21)
│ │ ├── index.ts # Database instance + collections │ │ ├── index.ts # Database instance + collections
│ │ └── sync.ts # Custom API sync adapter │ │ ├── sync.ts # Custom API sync adapter (25KB)
│ ├── models/ │ │ ├── migrations.ts # Schema migrations
│ │ ├── Task.ts │ │ ├── adapter.ts # Platform-specific adapters
│ │ ├── Category.ts │ │ └── tombstones.ts # Deleted record tracking
│ │ └── Subtask.ts
│ ├── hooks/ │ ├── hooks/
│ │ ├── useDatabase.tsx # Database context & providers │ │ ├── useDatabase.tsx # Database context & providers
│ │ └── useTasks.tsx # Task queries with reactive state │ │ ├── useTasks.tsx # Task queries with reactive state
│ ├── constants/ │ │ ├── useCategories.tsx # Category queries
│ │ └── index.ts # Categories, priorities, colors │ │ ├── useTasksByDate.tsx # Calendar date queries
│ └── types/ │ │ ├── useFriends.tsx # Friends state & actions
│ └── index.ts # TypeScript interfaces │ │ ├── useAuth.tsx # Authentication state
│ │ └── useStats.tsx # Statistics computation
│ ├── models/
│ │ ├── Task.ts # Task model (assigneeId, repeat, reminders)
│ │ ├── Category.ts
│ │ ├── Subtask.ts
│ │ ├── RepeatProfile.ts
│ │ ├── Friendship.ts
│ │ └── Tombstone.ts
│ ├── services/
│ │ ├── api.ts # API client with auth
│ │ ├── auth.ts # Auth token management
│ │ ├── friends.ts # Friends API calls
│ │ ├── notifications.ts # Reminder scheduling (expo-notifications)
│ │ ├── repeat.ts # Repeat task generation
│ │ └── taskActions.ts # Task CRUD + sync operations
│ ├── theme/
│ │ ├── index.ts # Theme context, colors, spacing
│ │ └── theme.tsx # Accent color picker, settings sync
│ ├── types/
│ │ └── index.ts # TypeScript interfaces
│ └── utils/
│ ├── date.ts # Date formatting utilities
│ ├── format.ts # General formatting
│ └── validation.ts # Zod schemas
├── backend/ # Backend API (separate package)
│ ├── src/
│ │ ├── index.ts # Express app entry
│ │ ├── db/
│ │ │ ├── schema.ts # Drizzle schema (Postgres)
│ │ │ └── index.ts # DB connection
│ │ ├── routes/
│ │ │ ├── auth.ts # Register, login, me, forgot/reset password
│ │ │ ├── categories.ts # Category CRUD
│ │ │ ├── tasks.ts # Task CRUD + batch
│ │ │ ├── subtasks.ts # Subtask CRUD
│ │ │ ├── sync.ts # Pull/push sync endpoints
│ │ │ ├── users.ts # User profile & settings
│ │ │ ├── friends.ts # Friend requests, search, management
│ │ │ ├── repeatProfiles.ts# Repeat profile CRUD
│ │ │ └── pushNotifications.ts
│ │ ├── middleware/
│ │ │ ├── auth.ts # JWT verification
│ │ │ ├── errorHandler.ts
│ │ │ └── validation.ts # Zod validation middleware
│ │ ├── services/
│ │ └── utils/
│ ├── drizzle.config.ts
│ └── Dockerfile
├── electron/ # Desktop app entry
├── android/ # Native Android project
├── assets/ # Images, fonts
├── patches/ # patch-package fixes
└── plugins/ # Expo config plugins
``` ```
---
## Data Models ## Data Models
### Task ### Task
@@ -144,8 +295,14 @@ carry-your-live/
categoryId: string; categoryId: string;
priority: 'none' | 'low' | 'medium' | 'high' | 'critical'; priority: 'none' | 'low' | 'medium' | 'high' | 'critical';
completed: boolean; completed: boolean;
dueDate: number; // timestamp dueDate: number; // timestamp (ms)
dueTime: string; // "HH:MM" dueTime: string; // "HH:MM" (24h stored, 12h displayed)
allDay: boolean;
assigneeId: string | null;
repeatProfileId: string | null;
seriesId: string | null; // For repeating tasks
isTemplate: boolean; // Series template
reminderOffset: string | null; // e.g., "5m", "1h", "1d"
createdAt: Date; createdAt: Date;
updatedAt: Date; updatedAt: Date;
subtasks: Subtask[]; subtasks: Subtask[];
@@ -159,6 +316,8 @@ carry-your-live/
name: string; name: string;
color: '#HEX'; color: '#HEX';
order: number; order: number;
createdAt: Date;
updatedAt: Date;
} }
``` ```
@@ -167,14 +326,47 @@ carry-your-live/
{ {
id: string; id: string;
taskId: string; taskId: string;
parentSubtaskId: string | null; // For nesting
title: string; title: string;
completed: boolean; completed: boolean;
order: number; order: number;
assigneeId: string | null;
createdAt: Date; createdAt: Date;
updatedAt: Date; updatedAt: Date;
} }
``` ```
### Repeat Profile
```typescript
{
id: string;
name: string;
frequency: 'daily' | 'weekly' | 'monthly' | 'yearly' | 'custom';
interval: number;
daysOfWeek: number[]; // 0-6 for weekly
dayOfMonth: number | null; // For monthly
monthOfYear: number | null; // For yearly
endDate: number | null; // Timestamp
occurrences: number | null;
createdAt: Date;
updatedAt: Date;
}
```
### Friendship
```typescript
{
id: string;
userId: string; // Requester
friendId: string; // Recipient
status: 'pending' | 'accepted' | 'declined' | 'blocked';
createdAt: Date;
updatedAt: Date;
}
```
---
## Default Categories ## Default Categories
| Name | Color | Order | | Name | Color | Order |
|------|-------|-------| |------|-------|-------|
@@ -185,6 +377,8 @@ carry-your-live/
| Health | #8E24AA (Purple) | 4 | | Health | #8E24AA (Purple) | 4 |
| Finance | #FDD835 (Yellow) | 5 | | Finance | #FDD835 (Yellow) | 5 |
---
## Priority Colors ## Priority Colors
| Priority | Color | | Priority | Color |
|----------|-------| |----------|-------|
@@ -194,6 +388,8 @@ carry-your-live/
| High | #E53935 | | High | #E53935 |
| Critical | #B71C1C | | Critical | #B71C1C |
---
## Getting Started ## Getting Started
### Prerequisites ### Prerequisites
@@ -201,15 +397,23 @@ carry-your-live/
- npm or yarn - npm or yarn
- Expo CLI (`npm install -g expo-cli`) - Expo CLI (`npm install -g expo-cli`)
- iOS Simulator (Mac) / Android Studio for mobile testing - iOS Simulator (Mac) / Android Studio for mobile testing
- PostgreSQL 16+ (or Docker)
### Installation ### Installation
```bash ```bash
cd carry-your-live cd carry-your-live
npm install npm install
cd ../backend
npm install
``` ```
### Development ### Development
#### Frontend
```bash ```bash
cd carry-your-live
# Start Expo dev server # Start Expo dev server
npx expo start npx expo start
@@ -219,6 +423,37 @@ npx expo start --android
npx expo start --web npx expo start --web
``` ```
#### Backend
```bash
cd backend
# Start PostgreSQL (Docker)
docker-compose up -d postgres
# Configure environment
cp .env.example .env
# Edit .env with your settings
# Run migrations
npm run db:push
# Start dev server
npm run dev
```
Server runs at `http://localhost:3000` (health check: `GET /health`)
#### Desktop (Electron)
```bash
cd carry-your-live
# Development with live reload
npm run desktop:dev
# Production build
npm run desktop:dist
```
### Building ### Building
#### EAS Build (cloud) #### EAS Build (cloud)
@@ -234,18 +469,16 @@ eas build --platform ios
eas build --platform android eas build --platform android
eas build --platform web eas build --platform web
``` ```
Profiles are defined in `eas.json` (`development`, `preview`, `production`; production auto-increments version code). Profiles defined in `eas.json` (`development`, `preview`, `production`; production auto-increments version code).
#### Gradle (local Android APK) #### Gradle (local Android APK)
The native Android project lives in `carry-your-live/android/`. Requires JDK 17+ and the Android SDK (platform 35, build-tools 35.0.0, NDK 27.1).
```bash ```bash
cd carry-your-live/android cd carry-your-live/android
# Debug APK (unsigned) # Debug APK (unsigned)
./gradlew assembleDebug ./gradlew assembleDebug
# Release APK (currently signed with the debug keystore) # Release APK (signed with debug keystore)
./gradlew assembleRelease ./gradlew assembleRelease
``` ```
Output: Output:
@@ -253,24 +486,21 @@ Output:
android/app/build/outputs/apk/debug/app-debug.apk android/app/build/outputs/apk/debug/app-debug.apk
android/app/build/outputs/apk/release/app-release.apk android/app/build/outputs/apk/release/app-release.apk
``` ```
Key notes:
- The debug keystore (`android/app/debug.keystore`) is generated by the CI pipeline and must exist for release builds — create it locally with the same command used in the pipeline (see below) if it's missing. ---
- Release builds use `signingConfig signingConfigs.debug` until a production keystore is configured.
- Versions are set in `android/app/build.gradle` (`versionCode`, `versionName`).
## CI/CD Pipeline (Gitea Actions) ## CI/CD Pipeline (Gitea Actions)
`.gitea/workflows/build-apk.yml` builds a release APK on every push to `main` (also manually triggerable via workflow_dispatch): `.gitea/workflows/build-apk.yml` builds a release APK on every push to `main` (also manually triggerable via `workflow_dispatch`):
1. **Checkout** and setup Node 22, JDK 17 (Temurin) 1. **Checkout** and setup Node 22, JDK 17 (Temurin)
2. **Android SDK**: installs cmdline-tools, licenses, platform-tools, `platforms;android-35`, `build-tools;35.0.0`, `ndk;27.1.12297006` 2. **Android SDK**: installs cmdline-tools, licenses, platform-tools, `platforms;android-35`, `build-tools;35.0.0`, `ndk;27.1.12297006`
3. **JS deps**: `npm ci` in `carry-your-live/` 3. **JS deps**: `npm ci` in `carry-your-live/`
4. **Debug keystore**: generates `carry-your-live/android/app/debug.keystore` with `keytool` (alias `androiddebugkey`, passwords `android`) 4. **Debug keystore**: generates `carry-your-live/android/app/debug.keystore` with `keytool`
5. **Build**: `./gradlew assembleRelease` in `carry-your-live/android/` 5. **Build**: `./gradlew assembleRelease` in `carry-your-live/android/`
6. **Upload**: the APK is saved as the `carry-your-live-release` artifact (downloadable from the run's artifacts page) 6. **Upload**: APK saved as `carry-your-live-release` artifact
To run the build locally exactly as CI does:
To run locally exactly as CI does:
```bash ```bash
keytool -genkeypair -v \ keytool -genkeypair -v \
-keystore carry-your-live/android/app/debug.keystore \ -keystore carry-your-live/android/app/debug.keystore \
@@ -280,48 +510,119 @@ keytool -genkeypair -v \
cd carry-your-live/android && ./gradlew assembleRelease cd carry-your-live/android && ./gradlew assembleRelease
``` ```
## Sync API Specification ---
The app expects a custom API at `http://localhost:3000/api` (configurable in `src/database/sync.ts`): ## Backend API Specification
### Pull Changes Server runs at `http://localhost:3000/api` (configurable in `src/services/api.ts` and `src/database/sync.ts`):
```
GET /sync?since={timestamp}
```
Response:
```json
{
"categories": [{ "id", "name", "color", "order", "createdAt", "updatedAt" }],
"tasks": [{ "id", "title", "description", "categoryId", "priority", "completed", "dueDate", "dueTime", "createdAt", "updatedAt" }],
"subtasks": [{ "id", "taskId", "title", "completed", "order", "createdAt", "updatedAt" }],
"timestamp": 1234567890
}
```
### Push Changes ### Authentication
``` - `POST /api/auth/register` - Register new user
POST /sync/push - `POST /api/auth/login` - Login (returns access + refresh tokens)
``` - `POST /api/auth/refresh` - Refresh access token
Body: - `POST /api/auth/forgot-password` - Request password reset
```json - `POST /api/auth/reset-password` - Reset password with token
{ - `GET /api/auth/me` - Get current user
"changes": {
"categories": [...], ### Categories
"tasks": [...], - `GET /api/categories` - List categories
"subtasks": [...] - `POST /api/categories` - Create category
}, - `PATCH /api/categories/:id` - Update category
"lastPulledAt": 1234567890 - `DELETE /api/categories/:id` - Delete category
}
``` ### Tasks
- `GET /api/tasks` - List tasks (with filters: category, completed, due date range, assignee)
- `GET /api/tasks/:id` - Get task with subtasks
- `POST /api/tasks` - Create task
- `PATCH /api/tasks/:id` - Update task
- `DELETE /api/tasks/:id` - Delete task (scopes: this/future/all for repeating)
- `POST /api/tasks/batch` - Batch operations
### Subtasks
- `GET /api/subtasks/task/:taskId` - List subtasks for task
- `POST /api/subtasks/task/:taskId` - Create subtask
- `PATCH /api/subtasks/:id` - Update subtask
- `DELETE /api/subtasks/:id` - Delete subtask
### Repeat Profiles
- `GET /api/repeat-profiles` - List repeat profiles
- `POST /api/repeat-profiles` - Create repeat profile
- `PATCH /api/repeat-profiles/:id` - Update repeat profile
- `DELETE /api/repeat-profiles/:id` - Delete repeat profile
### Users
- `GET /api/users/me` - Get user with settings
- `PATCH /api/users/me/settings` - Update settings (darkMode, defaultCategoryId, sortOrder, etc.)
- `GET /api/users/search` - Search users (for friends)
### Friends
- `GET /api/friends` - List accepted friends
- `GET /api/friends/requests` - List pending requests (incoming/outgoing)
- `POST /api/friends/request` - Send friend request
- `PATCH /api/friends/request/:id/accept` - Accept request
- `PATCH /api/friends/request/:id/decline` - Decline request
- `DELETE /api/friends/:id` - Remove friend
### Sync (Offline-first)
- `GET /api/sync?since=<timestamp>` - Pull changes since timestamp
- `POST /api/sync/push` - Push local changes
---
## Sync Protocol
The sync endpoint uses a cursor-based approach with tombstones:
1. **Pull**: Client sends `since` timestamp, server returns all changes since then
```json
{
"categories": [...],
"tasks": [...],
"subtasks": [...],
"repeatProfiles": [...],
"friendships": [...],
"tombstones": [...],
"timestamp": 1234567890
}
```
2. **Push**: Client sends batched changes with `lastPulledAt`
```json
{
"changes": {
"categories": [...],
"tasks": [...],
"subtasks": [...],
"repeatProfiles": [...],
"friendships": [...]
},
"tombstones": [...],
"lastPulledAt": 1234567890
}
```
3. **Conflict Resolution**: Last-write-wins based on `updatedAt` (customizable in `src/database/sync.ts`)
---
## Configuration ## Configuration
### Environment Variables ### Frontend Environment Variables
Create `.env` file: Create `.env` file in `carry-your-live/`:
``` ```
EXPO_PUBLIC_API_URL=http://your-api-url/api EXPO_PUBLIC_API_URL=http://your-api-url/api
``` ```
### Backend Environment Variables
Create `.env` file in `backend/`:
```
DATABASE_URL=postgresql://user:pass@localhost:5432/carry_your_live
JWT_SECRET=your-32-char-secret
PORT=3000
NODE_ENV=development
FRONTEND_URL=http://localhost:8081
```
### App Config ### App Config
Modify `app.json` for: Modify `app.json` for:
- App name, slug, version - App name, slug, version
@@ -329,10 +630,12 @@ Modify `app.json` for:
- Permissions (notifications, etc.) - Permissions (notifications, etc.)
- Orientation, theme - Orientation, theme
---
## Visual Style Guide ## Visual Style Guide
- **Background**: White (#FFFFFF) - **Background**: White (#FFFFFF) / Dark mode (planned)
- **Primary Accent**: #E53935 (Pink/Red) - **Primary Accent**: #E53935 (Pink/Red) - customizable
- **Typography**: Black (#212121) primary, #757575 secondary, #9E9E9E tertiary - **Typography**: Black (#212121) primary, #757575 secondary, #9E9E9E tertiary
- **Borders**: Thin (#E0E0E0), selected #E53935 - **Borders**: Thin (#E0E0E0), selected #E53935
- **Radius**: 16-20px for cards/buttons/inputs - **Radius**: 16-20px for cards/buttons/inputs
@@ -340,11 +643,13 @@ Modify `app.json` for:
- **Shadows**: Minimal (elevation 1-3) - **Shadows**: Minimal (elevation 1-3)
- **Animations**: 150-250ms, cubic easing - **Animations**: 150-250ms, cubic easing
---
## Offline-First Architecture ## Offline-First Architecture
``` ```
┌─────────────┐ ┌──────────────┐ ┌─────────────┐ ┌─────────────┐ ┌──────────────┐ ┌─────────────┐
│ Expo App │────▶│ WatermelonDB │────▶│ Your API │ │ Expo App │────▶│ WatermelonDB │────▶│ Backend │
│ (iOS/Android│ │ (SQLite) │ │ (Postgres) │ │ (iOS/Android│ │ (SQLite) │ │ (Postgres) │
│ Web) │◀───▶│ + Sync │◀───▶│ │ │ Web) │◀───▶│ + Sync │◀───▶│ │
└─────────────┘ └──────────────┘ └─────────────┘ └─────────────┘ └──────────────┘ └─────────────┘
@@ -354,6 +659,79 @@ Modify `app.json` for:
2. Reactive queries update UI instantly 2. Reactive queries update UI instantly
3. Background sync pushes/pulls changes 3. Background sync pushes/pulls changes
4. Conflict resolution: last-write-wins (customizable) 4. Conflict resolution: last-write-wins (customizable)
5. Tombstones track deletions for sync
---
## Current Implementation Status
Based on code audit (August 2026):
| Feature | Status | Notes |
|---------|--------|-------|
| Core CRUD (tasks, subtasks, categories) | ✅ Complete | |
| Nested subtasks | ✅ Complete | Unlimited depth |
| Repeating tasks | ✅ Complete | Profiles, series, this/future/all delete |
| Categories & priorities | ✅ Complete | |
| Calendar with date strip | ✅ Complete | Month nav, day detail |
| Stats screen | ✅ Complete | Client-side only |
| Settings screen | ✅ Complete | Most settings wired |
| Friends system | ✅ Complete | Backend + UI |
| Task assignees | ✅ Complete | Schema v7, UI, sync |
| QuickAddBar | ✅ Complete | Tasks + Calendar |
| Offline sync (WatermelonDB) | ✅ Complete | Schema v21, tombstones |
| Backend API | ✅ Complete | Express + Drizzle + Postgres |
| Auth (JWT) | ✅ Complete | Register, login, refresh, forgot/reset |
| Dark mode / theme toggle | ❌ Missing | Backend column exists, UI not implemented |
| Notifications toggle | 🟡 Partial | Stored but not respected |
| Global reminder preference | 🟡 Partial | Stored but not applied |
| Forgot/reset password UI | 🟡 Partial | Backend done, no client UI |
| Pull-to-refresh → sync | 🟡 Partial | Reloads local only |
| Client settings sync | 🟡 Partial | AsyncStorage only, not synced to backend |
| Reminder enum mismatch | 🟡 Partial | Client uses '5m'/'1h', spec uses minutes |
---
## Roadmap Highlights
### v1.1.0 — Friends & Assignees (Current Unreleased)
- Ship existing Unreleased changes
- Fix notifications toggle, wire up `rescheduleAllReminders()`
- Apply global reminder preference
- Make pull-to-refresh trigger real sync
- Add forgot/reset password UI
- Unify reminder offset enums
### v1.2.0 — Theming & Findability
- Light mode + follow-system-theme
- Sync all settings to `PATCH /users/me/settings`
- Task search (filter + global)
- Friend request badges/indicators
### v1.3.0 — Stats & Insights
- Persisted stats snapshots
- Productivity trends, streaks
- Export stats (CSV/image)
### v1.4.0 — Quick Capture & Calendar UX
- Natural language quick-add
- Drag-and-drop rescheduling in calendar
- Month grid view
- "Today at a glance" dashboard
### v1.5.0 — Power Tools & Personalization
- Task templates, soft-archive, attachments
- Markdown support, deep links
- Biometric lock, haptics, reduced motion
- Android home-screen widget
### v2.0.0 — Collaboration
- Real task assignment delivery
- Shared lists with permissions
- Server push notifications (FCM/APNs)
- Comments/activity feed
---
## Contributing ## Contributing
@@ -362,6 +740,9 @@ Modify `app.json` for:
3. Write components with React Hook Form + Zod 3. Write components with React Hook Form + Zod
4. Use WatermelonDB decorators for models 4. Use WatermelonDB decorators for models
5. Test offline scenarios 5. Test offline scenarios
6. Run `npm run lint` and `npm run typecheck` before committing
---
## License ## License