A minimal, mobile-first fasting tracker PWA built with React, TypeScript, and Tailwind CSS.

Features

• Lazy & Minimal: No clutter. No titles. No "Add" buttons. Just start and stop.
• Mobile-First Design: Optimized for touch interactions and mobile screens.
• PWA Support: Installable on iOS and Android. Works offline.
• Fast Tracking: Simple start/stop interface for tracking fasting sessions.
• Fast History: View and manage your past fasting sessions in the log.
• Edit & Delete: Modify or remove past fasting sessions.
• Persistence: Data is saved automatically to your device's local storage.
• Dark Mode: Automatic device-driven dark mode support.

Tech Stack

• Framework: React + TypeScript
• Build Tool: Vite
• Styling: Tailwind CSS v4
• PWA: vite-plugin-pwa + Workbox
• Testing: Vitest + React Testing Library
• CI/CD: GitHub Actions

Getting Started

Prerequisites

• Node.js (v20 or later recommended)
• npm

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/fast.git
   cd fast

2. Install dependencies:

Development

Start the development server:

Testing

Run the unit tests:

Building for Production

Build the app for deployment:

The output will be in the dist directory.

Deployment

This project is configured to deploy automatically to GitHub Pages using GitHub Actions.

1. Push changes to the main branch.
2. The workflow in .github/workflows/deploy.yml will build and deploy the app.
3. Ensure your repository Settings > Pages source is set to "GitHub Actions".

License

MIT