Upload 4 files

.gitignore

@@ -0,0 +1,3 @@
+.venv/
+__pycache__/
+*.pyc

README.md

@@ -0,0 +1,85 @@
+---
+title: Time Card Generator
+emoji: ⏱️
+colorFrom: green
+colorTo: blue
+sdk: streamlit
+sdk_version: 1.37.0
+app_file: app.py
+pinned: false
+---
+
+# Time Card Generator
+
+A Streamlit application for creating, editing, and saving shift cards to a Google Sheet through a Google Apps Script Web App. The UI is optimized for Hugging Face Streamlit Spaces and uses only HTTP requests for persistence.
+
+## Features
+
+- Add unlimited time cards
+- Edit title and start time inline
+- Automatically calculate end time as `+2 hours`
+- Save new cards and update existing cards
+- Delete cards locally or from Google Sheets
+- Load saved cards automatically on startup
+- Use `st.session_state` for responsive card management
+
+## Project Structure
+
+```text
+streamlit_app/
+├── app.py
+├── requirements.txt
+├── README.md
+├── .gitignore
+├── assets/
+│   └── style.css
+├── components/
+│   ├── buttons.py
+│   ├── card.py
+│   └── header.py
+├── services/
+│   └── api.py
+├── utils/
+│   └── time_utils.py
+└── .streamlit/
+    └── secrets.toml.example
+```
+
+## Configuration
+
+1. Deploy the Google Apps Script from the `google_apps_script/` folder.
+2. Copy the Web App URL.
+3. Create `.streamlit/secrets.toml` from the example file:
+
+```toml
+WEB_APP_URL="https://script.google.com/macros/s/your-deployment-id/exec"
+```
+
+This repository is already configured with the deployed URL in `.streamlit/secrets.toml`:
+
+```toml
+WEB_APP_URL="https://script.google.com/macros/s/AKfycbxJbzf0n0KWpAiWz9lXq5yGYw7igNFmAzrZ2qgwYRWqWPodW4CRw75qEOIrQW8knRNz5Q/exec"
+```
+
+If you create a new Apps Script deployment later, update that file or replace it with a Hugging Face Space secret.
+
+## Run Locally
+
+```bash
+cd streamlit_app
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+streamlit run app.py
+```
+
+## Deploy to Hugging Face Streamlit Space
+
+1. Create a new Hugging Face Space.
+2. Choose `Streamlit` as the SDK.
+3. Upload the contents of `streamlit_app/`.
+4. This repo can run without extra edits because `.streamlit/secrets.toml` is included.
+5. Optionally, add a Hugging Face Space secret named `WEB_APP_URL` if you prefer managing the URL outside the repo.
+6. Commit and let the Space build automatically.
+
+For detailed setup, see the root guide in [`../google_apps_script/README.md`](/home/huy/timemini/google_apps_script/README.md) and the Apps Script deployment section there.

app.py

@@ -0,0 +1,131 @@
+import streamlit as st
+
+from components.buttons import render_add_card_button
+from components.card import render_card
+from components.header import render_header
+from services.api import delete_card as api_delete_card
+from services.api import load_cards, save_card, update_card
+from utils.time_utils import build_card_payload, normalize_cards
+
+
+st.set_page_config(
+    page_title="Time Card Generator",
+    page_icon="⏱️",
+    layout="wide",
+    initial_sidebar_state="collapsed",
+)
+
+
+def load_css() -> None:
+    with open("assets/style.css", "r", encoding="utf-8") as css_file:
+        st.markdown(f"<style>{css_file.read()}</style>", unsafe_allow_html=True)
+
+
+def initialize_state() -> None:
+    if "cards" not in st.session_state:
+        st.session_state.cards = []
+    if "cards_loaded" not in st.session_state:
+        st.session_state.cards_loaded = False
+    if "status_message" not in st.session_state:
+        st.session_state.status_message = None
+    if "status_type" not in st.session_state:
+        st.session_state.status_type = "info"
+
+
+def set_status(message: str, status_type: str = "info") -> None:
+    st.session_state.status_message = message
+    st.session_state.status_type = status_type
+
+
+def clear_status() -> None:
+    st.session_state.status_message = None
+    st.session_state.status_type = "info"
+
+
+def fetch_cards_once() -> None:
+    if st.session_state.cards_loaded:
+        return
+
+    try:
+        st.session_state.cards = normalize_cards(load_cards())
+        st.session_state.cards_loaded = True
+        clear_status()
+    except Exception as exc:  # noqa: BLE001
+        st.session_state.cards = []
+        st.session_state.cards_loaded = True
+        set_status(f"Unable to load saved cards: {exc}", "error")
+
+
+def add_card() -> None:
+    st.session_state.cards.append(build_card_payload())
+    clear_status()
+
+
+def delete_local_card(index: int) -> None:
+    st.session_state.cards.pop(index)
+    clear_status()
+
+
+def handle_delete(index: int) -> None:
+    card = st.session_state.cards[index]
+    card_id = card.get("id")
+
+    if not card_id:
+        delete_local_card(index)
+        return
+
+    try:
+        api_delete_card(card_id)
+        delete_local_card(index)
+        set_status("Card deleted.", "success")
+    except Exception as exc:  # noqa: BLE001
+        set_status(f"Delete failed: {exc}", "error")
+
+
+def handle_save(index: int) -> None:
+    card = st.session_state.cards[index]
+
+    if not card["title"].strip():
+        set_status("Title is required before saving.", "warning")
+        return
+
+    try:
+        if card.get("id"):
+            updated_card = update_card(card)
+            st.session_state.cards[index] = updated_card
+            set_status("Card updated.", "success")
+        else:
+            saved_card = save_card(card)
+            st.session_state.cards[index] = saved_card
+            set_status("Card saved.", "success")
+    except Exception as exc:  # noqa: BLE001
+        set_status(f"Save failed: {exc}", "error")
+
+
+load_css()
+initialize_state()
+fetch_cards_once()
+render_header()
+
+if st.session_state.status_message:
+    getattr(st, st.session_state.status_type)(st.session_state.status_message)
+
+render_add_card_button(add_card)
+
+if not st.session_state.cards:
+    st.markdown(
+        """
+        <div class="empty-state">
+            <h3>No time cards yet</h3>
+            <p>Create your first card to start tracking shifts and save them to Google Sheets.</p>
+        </div>
+        """,
+        unsafe_allow_html=True,
+    )
+
+for index, _card in enumerate(st.session_state.cards):
+    render_card(
+        index=index,
+        on_save=handle_save,
+        on_delete=handle_delete,
+    )

requirements.txt

@@ -0,0 +1,2 @@
+streamlit>=1.37.0
+requests>=2.32.0