refactor: implement authentication flow using authHash in unlock hook and update PasskeyModal UI

Co-authored-by: me <ramvignesh-b@github.com>
Co-authored-by: ramvignesh-b <ramvignesh-b@github.com>
Reviewed-on: #1

.github/workflows/ci.yml

@@ -6,13 +6,6 @@ on:
   pull_request:
     branches: [ main ]
 
-env:
-  # WHY?: services are executed way before the env can be sourced from .env file
-  # NOTE: still inlining these values because of gitea misbehaving with env loads
-  DB_NAME: piku_test_db
-  DB_USER: test
-  DB_PASSWORD: password123
-
 jobs:
   setup-environment:
     name: Generate Certificates
@@ -69,10 +62,10 @@ jobs:
     runs-on: ubuntu-latest
     needs: setup-environment
     services:
-      postgres:
+      db:
         image: postgres:16-alpine
         env:
-          POSTGRES_DB: piku_test_db
+          POSTGRES_DB: piku__test
           POSTGRES_USER: test
           POSTGRES_PASSWORD: password123
         ports:
@@ -95,15 +88,17 @@ jobs:
           name: ssl-certs
           path: certs/
 
-      - name: Setup Environment
+      - name: Setup & Test
         run: |
           cp ../.env.example ../.env
           uv sync
 
-      - name: Lint & Test
+          export DB_NAME="piku__test"
-        run: |
+          export DB_USER="test"
+          export DB_PASSWORD="password123"
+
           if [ "$GITEA_ACTIONS" = "true" ]; then
-            export DB_HOST="postgres"
+            export DB_HOST="db"
             export DB_PORT="5432"
           else
             export DB_HOST="127.0.0.1"
@@ -138,7 +133,7 @@ jobs:
         # Disable cache when not using GitHub Actions because the runner spends ~3mins trying to upload the cache and failing
         # TODO: setup cache server in Gitea
         if: github.server_url == 'https://github.com'
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: ~/.cache/ms-playwright
           key: ${{ runner.os }}-playwright-${{ hashFiles('frontend/bun.lock') }}

frontend/src/App.tsx

@@ -1,11 +1,5 @@
 import { lazy, Suspense, useEffect, useRef } from "react";
-import {
+import { BrowserRouter, Navigate, Route, Routes } from "react-router-dom";
-  BrowserRouter,
-  Navigate,
-  Route,
-  Routes,
-  ScrollRestoration,
-} from "react-router-dom";
 import { ProtectedRoute, PublicRoute } from "./components/RouteGuards";
 import SplashScreen from "./components/SplashScreen";
 import { ROUTES } from "./config/routes";

frontend/src/components/drawer/PasskeyModal.tsx

@@ -1,26 +1,26 @@
-import { LockKeyIcon } from "@phosphor-icons/react";
+import { HourglassSimpleMediumIcon } from "@phosphor-icons/react";
+import { useAuth } from "../../hooks/useAuth";
 import { Modal } from "../ui/Modal";
 
-interface PasskeyModalProps {
+export function PasskeyModal() {
-  onUnlock: (password: string) => Promise<void>;
+  const { unlock } = useAuth();
-}
 
-export function PasskeyModal({ onUnlock }: PasskeyModalProps) {
   return (
     <Modal isOpen={true}>
-      <LockKeyIcon
+      <HourglassSimpleMediumIcon
         size={48}
         className="text-primary mx-auto mb-8 animate-pulse"
+        weight="duotone"
       />
       <h3 className="font-bold text-lg font-display text-primary">
-        Authentication Required
+        You've been away a while.
       </h3>
       <p className="py-4 font-sans">
-        We need your passkey to open your letters
+        Your letters are still there. Just need the key once more.
       </p>
       <div className="divider w-1/2 mx-auto text-xs text-neutral-content/30 mt-0"></div>
       <p className="text-xs text-neutral-content/30 font-mono italic">
-        Your passkey is used to decrypt your data locally.
+        Nothing was lost.
       </p>
       <div className="modal-action items-center gap-4">
         <form
@@ -30,7 +30,7 @@ export function PasskeyModal({ onUnlock }: PasskeyModalProps) {
             const formData = new FormData(e.currentTarget);
             const password = formData.get("password") as string;
             if (!password) return;
-            await onUnlock(password);
+            await unlock(password);
           }}
         >
           <input

frontend/src/hooks/useAuth.test.ts

@@ -6,6 +6,7 @@ import { mockUser } from "../../test/fixtures/user.fixture";
 import { server } from "../../test/mocks/server";
 import { useAuthStore } from "../store/useAuthStore";
 import { useKeyStore } from "../store/useKeyStore";
+import { CryptoUtils } from "../utils/crypto";
 import {
   clearMasterKey,
   loadMasterKey,
@@ -14,6 +15,7 @@ import {
 import { useAuth } from "./useAuth";
 
 vi.mock("../utils/keystore");
+vi.mock("../utils/crypto");
 
 const VITE_API_URL = "http://piku-server";
 
@@ -30,6 +32,11 @@ beforeEach(() => {
     isInitializing: true,
   });
   useKeyStore.setState({ masterKey: null });
+
+  vi.mocked(CryptoUtils.deriveKeyBundle).mockResolvedValue({
+    masterKey: mockMasterKey,
+    authHash: "mock-hash",
+  });
 });
 
 describe("isAuthenticated", () => {
@@ -201,3 +208,68 @@ describe("initialize", () => {
     expect(useKeyStore.getState().masterKey).not.toBeNull();
   });
 });
+
+describe("unlock", () => {
+  beforeEach(() => {
+    useAuthStore.setState({
+      accessToken: "valid-token",
+      user: mockUser,
+      isInitializing: false,
+    });
+  });
+
+  it("should derive the master key from the user password, validate it via API, and persist it", async () => {
+    let loginCalled = false;
+    server.use(
+      http.post(`${VITE_API_URL}/api/auth/login/`, async () => {
+        loginCalled = true;
+        return HttpResponse.json({ access: "token", user: mockUser });
+      }),
+    );
+    const { result } = renderHook(() => useAuth());
+
+    await act(async () => {
+      await result.current.unlock("password");
+    });
+
+    expect(CryptoUtils.deriveKeyBundle).toHaveBeenCalledWith(
+      "password",
+      mockUser.email,
+    );
+    expect(loginCalled).toBe(true);
+    expect(saveMasterKey).toHaveBeenCalledWith(mockMasterKey);
+    expect(useKeyStore.getState().masterKey).toEqual(mockMasterKey);
+  });
+
+  it("should logout if user is not present", async () => {
+    useAuthStore.setState({ user: null });
+    const { result } = renderHook(() => useAuth());
+
+    await act(async () => {
+      await result.current.unlock("password");
+    });
+
+    expect(CryptoUtils.deriveKeyBundle).not.toHaveBeenCalled();
+    expect(saveMasterKey).not.toHaveBeenCalled();
+    expect(useAuthStore.getState().accessToken).toBeNull();
+    expect(clearMasterKey).toHaveBeenCalled();
+  });
+
+  it("should throw an error and not persist the key if validation fails", async () => {
+    server.use(
+      http.post(
+        `${VITE_API_URL}/api/auth/login/`,
+        () => new HttpResponse(null, { status: 400 }),
+      ),
+    );
+
+    const { result } = renderHook(() => useAuth());
+
+    await act(async () => {
+      await expect(result.current.unlock("wrong-password")).rejects.toThrow();
+    });
+
+    expect(saveMasterKey).not.toHaveBeenCalled();
+    expect(useKeyStore.getState().masterKey).toBeNull();
+  });
+});

frontend/src/hooks/useAuth.ts

@@ -57,7 +57,6 @@ export const useAuth = () => {
     }
 
     try {
-      // try session refresh
       const { data: refreshData } = await publicApi.post(endpoints.REFRESH);
       const { data: userData } = await api.get(endpoints.ME, {
         headers: { Authorization: `Bearer ${refreshData.access}` },
@@ -71,16 +70,24 @@ export const useAuth = () => {
   }, [setMasterKey]);
 
   const unlock = async (password: string) => {
-    if (!user) return;
+    if (!user) {
+      await logout();
+      return;
+    }
 
-    try {
+    const { masterKey, authHash } = await CryptoUtils.deriveKeyBundle(
-      const { masterKey } = await CryptoUtils.deriveKeyBundle(
+      password,
-        password,
+      user.email,
-        user.email,
+    );
-      );
+
-      await saveMasterKey(masterKey);
+    // Validate password by calling login endpoint
-      setMasterKey(masterKey);
+    await api.post(endpoints.LOGIN, {
-    } catch {}
+      email: user.email,
+      password: authHash,
+    });
+
+    await saveMasterKey(masterKey);
+    setMasterKey(masterKey);
   };
 
   return {

frontend/src/pages/Drawer.test.tsx

@@ -9,73 +9,75 @@ import Drawer from "./Drawer";
 vi.mock("../hooks/useLetters");
 
 describe("Drawer Page", () => {
-  beforeEach(() => {
+    beforeEach(() => {
-    // Setup authenticated state for the test
+        // Setup authenticated state for the test
-    useAuthStore.setState({
+        useAuthStore.setState({
-      user: mockUser,
+            user: mockUser,
-      accessToken: "fake-token",
+            accessToken: "fake-token",
-      isInitializing: false,
+            isInitializing: false,
+        });
+
+        vi.mocked(useLetters).mockReturnValue({
+            drafts: [],
+            kept: [],
+            sent: [],
+            vault: [],
+            loading: false,
+            isAuthRequired: false,
+        });
     });
 
-    vi.mocked(useLetters).mockReturnValue({
+    it("renders the cabinet sections and empty state message", () => {
-      drafts: [],
+        render(
-      kept: [],
+            <MemoryRouter>
-      sent: [],
+                <Drawer />
-      vault: [],
+            </MemoryRouter>,
-      loading: false,
+        );
-      isAuthRequired: false,
-    });
-  });
 
-  it("renders the cabinet sections and empty state message", () => {
+        expect(screen.getByText(/Drafts/i)).toBeInTheDocument();
-    render(
+        expect(screen.getAllByText(/Kept/i).length).toBeGreaterThanOrEqual(1);
-      <MemoryRouter>
+        expect(screen.getByText(/Vault/i)).toBeInTheDocument();
-        <Drawer />
+        expect(screen.getByText(/This drawer remains silent/i)).toBeInTheDocument();
-      </MemoryRouter>,
-    );
-
-    expect(screen.getByText(/Drafts/i)).toBeInTheDocument();
-    expect(screen.getAllByText(/Kept/i).length).toBeGreaterThanOrEqual(1);
-    expect(screen.getByText(/Vault/i)).toBeInTheDocument();
-    expect(screen.getByText(/This drawer remains silent/i)).toBeInTheDocument();
-  });
-
-  it("renders the loading state", () => {
-    vi.mocked(useLetters).mockReturnValue({
-      drafts: [],
-      kept: [],
-      sent: [],
-      vault: [],
-      loading: true,
-      isAuthRequired: false,
     });
 
-    render(
+    it("renders the loading state", () => {
-      <MemoryRouter>
+        vi.mocked(useLetters).mockReturnValue({
-        <Drawer />
+            drafts: [],
-      </MemoryRouter>,
+            kept: [],
-    );
+            sent: [],
+            vault: [],
+            loading: true,
+            isAuthRequired: false,
+        });
 
-    expect(screen.getByText(/Opening your cabinet/i)).toBeInTheDocument();
+        render(
-  });
+            <MemoryRouter>
+                <Drawer />
+            </MemoryRouter>,
+        );
 
-  it("renders the authentication required modal when api requires auth", () => {
+        expect(screen.getByText(/Opening your cabinet/i)).toBeInTheDocument();
-    vi.mocked(useLetters).mockReturnValue({
-      drafts: [],
-      kept: [],
-      sent: [],
-      vault: [],
-      loading: false,
-      isAuthRequired: true,
     });
 
-    render(
+    it("renders the authentication required modal when api requires auth", () => {
-      <MemoryRouter>
+        vi.mocked(useLetters).mockReturnValue({
-        <Drawer />
+            drafts: [],
-      </MemoryRouter>,
+            kept: [],
-    );
+            sent: [],
+            vault: [],
+            loading: false,
+            isAuthRequired: true,
+        });
 
-    expect(screen.getByText(/Authentication Required/i)).toBeInTheDocument();
+        render(
-    expect(screen.getByPlaceholderText(/password/i)).toBeInTheDocument();
+            <MemoryRouter>
-  });
+                <Drawer />
+            </MemoryRouter>,
+        );
+
+        expect(
+            screen.getByText(/You've been away a while./i),
+        ).toBeInTheDocument();
+        expect(screen.getByPlaceholderText(/password/i)).toBeInTheDocument();
+    });
 });

frontend/src/pages/Drawer.tsx

@@ -15,7 +15,7 @@ import {
 } from "../utils/dateFormat.ts";
 
 export default function Drawer() {
-  const { user, logout, unlock } = useAuth();
+  const { user, logout } = useAuth();
 
   const [openSection, setOpenSection] = useState<string | null>(null);
   const navigate = useNavigate();
@@ -30,7 +30,7 @@ export default function Drawer() {
     <div className="min-h-screen w-full bg-base-100 text-base-content flex flex-col items-center py-12 px-5 pb-32 font-serif transition-colors">
       <div className="fixed inset-0 bg-vig pointer-events-none z-0" />
 
-      {isAuthRequired && <PasskeyModal onUnlock={unlock} />}
+      {isAuthRequired && <PasskeyModal />}
       <header className="text-center mb-12 z-10 animate-in fade-in slide-in-from-top-4 duration-500">
         <Logo />
         <div className="font-sans text-xs tracking-widester uppercase text-base-content/40 mt-2">

frontend/src/pages/Home.tsx

@@ -1,9 +1,9 @@
 import { InfoIcon } from "@phosphor-icons/react";
+import { ReactLenis } from "lenis/react";
 import {
   motion,
   useMotionValueEvent,
   useScroll,
-  useSpring,
   useTransform,
 } from "motion/react";
 import { useRef, useState } from "react";
@@ -16,14 +16,9 @@ import { formatDate } from "../utils/dateFormat.ts";
 
 export default function Home() {
   const sectionContainer1 = useRef<HTMLDivElement>(null);
-  const { scrollYProgress: section1ScrollProgress } = useScroll({
+  const { scrollYProgress } = useScroll({
     target: sectionContainer1,
   });
-  const smoothProgress1 = useSpring(section1ScrollProgress, {
-    stiffness: 100,
-    damping: 30,
-    restDelta: 0.001,
-  });
   const [isEnvelopeFlipped, setIsEnvelopeFlipped] = useState(true);
   const [flapOpen, setFlapOpen] = useState(false);
   const [recipient, setRecipient] = useState("someone dear");
@@ -31,7 +26,7 @@ export default function Home() {
 
   const navigate = useNavigate();
 
-  useMotionValueEvent(section1ScrollProgress, "change", (latestScrollValue) => {
+  useMotionValueEvent(scrollYProgress, "change", (latestScrollValue) => {
     if (latestScrollValue > 0.54) {
       setFlapOpen(false);
     } else {
@@ -55,342 +50,348 @@ export default function Home() {
   });
 
   return (
-    <section
+    <ReactLenis root options={{ lerp: 0.1, duration: 1.5, smoothWheel: true }}>
-      ref={sectionContainer1}
+      <section
-      className="relative w-full h-[850vh] bg-base-100 font-serif"
+        ref={sectionContainer1}
-    >
+        className="relative w-full h-[850vh] bg-base-100 font-serif"
-      <div className="sticky top-0 h-screen w-full flex flex-col items-center justify-center overflow-hidden">
+      >
-        {/*  Intro */}
+        <div className="sticky top-0 h-screen w-full flex flex-col items-center justify-center overflow-hidden">
-        <motion.div
+          {/*  Intro */}
-          className="absolute flex flex-col items-center justify-center pointer-events-none"
-          style={{
-            opacity: useTransform(smoothProgress1, [0, 0.12, 1], [1, 0, 0]),
-            scale: useTransform(smoothProgress1, [0, 0.12], [1, 10]),
-          }}
-        >
-          <h1 className="text-neutral-content/40 text-4xl md:text-6xl text-center px-6">
-            You've been carrying something
-          </h1>
-          <h2 className="text-primary text-5xl md:text-7xl font-extralight mt-4 italic font-display animate-pulse">
-            unsaid
-          </h2>
-        </motion.div>
-
-        <motion.div
-          className="absolute text-center"
-          style={{
-            opacity: useTransform(smoothProgress1, [0, 0.15, 0.2], [0, 1, 0]),
-            y: useTransform(smoothProgress1, [0, 0.15, 0.2], [40, 0, -40]),
-            scale: useTransform(smoothProgress1, [0, 0.15, 0.2], [0.8, 1, 3]),
-          }}
-        >
-          <div className="mt-6 text-4xl md:text-6xl text-base-content/60 italic">
-            and that's okay...
-          </div>
-        </motion.div>
-        {/*  pi. ku. */}
-        <motion.div
-          className="absolute text-center px-6"
-          style={{
-            opacity: useTransform(
-              smoothProgress1,
-              [0.18, 0.25, 0.3],
-              [0, 1, 0],
-            ),
-            y: useTransform(smoothProgress1, [0.18, 0.25, 0.3], [20, 0, -20]),
-          }}
-          transition={{ delay: 4 }}
-        >
-          <Logo scale={2} />
           <motion.div
-            className="mt-6 text-4xl md:text-6xl text-base-content/60 "
+            className="absolute flex flex-col items-center justify-center pointer-events-none"
             style={{
-              opacity: useTransform(
+              opacity: useTransform(scrollYProgress, [0, 0.12, 1], [1, 0, 0]),
-                smoothProgress1,
+              scale: useTransform(scrollYProgress, [0, 0.12], [1, 10]),
-                [0.22, 0.25, 0.35, 0.4],
-                [0, 1, 1, 0],
-              ),
-              y: useTransform(
-                smoothProgress1,
-                [0.25, 0.3, 0.35, 0.4],
-                [20, 0, 0, -20],
-              ),
             }}
           >
-            is a{" "}
+            <h1 className="text-neutral-content/40 text-4xl md:text-6xl text-center px-6">
-            <span className="font-display text-primary font-extralight">
+              You've been carrying something
-              safe space
+            </h1>
-            </span>
+            <h2 className="text-primary text-5xl md:text-7xl font-extralight mt-4 italic font-display animate-pulse">
-            ,<br />
+              unsaid
-            <motion.span
+            </h2>
-              className="opacity-0 text-3xl md:text-5xl"
-              transition={{ delay: 3 }}
-              whileInView={{ opacity: 1 }}
-              viewport={{ once: false, amount: 0.3 }}
-            >
-              where you can
-            </motion.span>
           </motion.div>
-        </motion.div>
 
-        <div className="relative w-full max-w-5xl h-1/2 flex items-center justify-center mt-20">
+          <motion.div
-          <motion.h2
+            className="absolute text-center"
+            style={{
+              opacity: useTransform(scrollYProgress, [0, 0.15, 0.2], [0, 1, 0]),
+              y: useTransform(scrollYProgress, [0, 0.15, 0.2], [40, 0, -40]),
+              scale: useTransform(scrollYProgress, [0, 0.15, 0.2], [0.8, 1, 3]),
+            }}
+          >
+            <div className="mt-6 text-4xl md:text-6xl text-base-content/60 italic">
+              and that's okay...
+            </div>
+          </motion.div>
+          {/*  pi. ku. */}
+          <motion.div
+            className="absolute text-center px-6"
             style={{
               opacity: useTransform(
-                smoothProgress1,
+                scrollYProgress,
-                [0.3, 0.35, 0.4, 0.45],
+                [0.18, 0.25, 0.3],
-                [0, 1, 1, 0],
+                [0, 1, 0],
-              ),
-              y: useTransform(
-                smoothProgress1,
-                [0.3, 0.35, 0.4, 0.45],
-                [40, 0, 0, -40],
               ),
+              y: useTransform(scrollYProgress, [0.18, 0.25, 0.3], [20, 0, -20]),
             }}
-            className="absolute text-4xl md:text-6xl text-center px-10 leading-tight"
+            transition={{ delay: 4 }}
           >
-            pen down your unsaid words into{" "}
+            <Logo scale={2} />
-            <span className="font-display text-primary font-extralight">
+            <motion.div
-              letters
+              className="mt-6 text-4xl md:text-6xl text-base-content/60 "
-            </span>
-            .
-          </motion.h2>
-          {/*  Seal */}
-          <motion.h2
-            style={{
-              opacity: useTransform(
-                smoothProgress1,
-                [0.45, 0.5, 0.55, 0.6],
-                [0, 1, 1, 0],
-              ),
-              y: useTransform(
-                smoothProgress1,
-                [0.45, 0.5, 0.55, 0.6],
-                [40, 0, 0, -40],
-              ),
-            }}
-            className="absolute text-4xl md:text-6xl text-center px-10 leading-tight"
-          >
-            seal it{" "}
-            <span className="text-secondary font-display italic font-extralight">
-              secure
-            </span>{" "}
-            and{" "}
-            <span className="text-secondary font-display font-extralight italic">
-              private
-            </span>
-            .
-          </motion.h2>
-          {/*  Send / vault */}
-          <motion.h2
-            style={{
-              opacity: useTransform(
-                smoothProgress1,
-                [0.6, 0.63, 0.72, 0.75],
-                [0, 1, 1, 0],
-              ),
-              y: useTransform(
-                smoothProgress1,
-                [0.6, 0.63, 0.72, 0.75],
-                [40, 0, 0, -40],
-              ),
-            }}
-            className="absolute text-4xl md:text-6xl text-center px-10 leading-tight"
-          >
-            send it to{" "}
-            <motion.span
-              className="font-display text-accent"
               style={{
-                color: useTransform(
+                opacity: useTransform(
-                  smoothProgress1,
+                  scrollYProgress,
-                  [0.67, 1],
+                  [0.22, 0.25, 0.35, 0.4],
-                  ["var(--color-accent)", "var(--color-neutral)"],
+                  [0, 1, 1, 0],
+                ),
+                y: useTransform(
+                  scrollYProgress,
+                  [0.25, 0.3, 0.35, 0.4],
+                  [20, 0, 0, -20],
                 ),
               }}
             >
-              someone dear
+              is a{" "}
-            </motion.span>
+              <span className="font-display text-primary font-extralight">
-            <motion.span
+                safe space
+              </span>
+              ,<br />
+              <motion.span
+                className="opacity-0 text-3xl md:text-5xl"
+                transition={{ delay: 3 }}
+                whileInView={{ opacity: 1 }}
+                viewport={{ once: false, amount: 0.3 }}
+              >
+                where you can
+              </motion.span>
+            </motion.div>
+          </motion.div>
+
+          <div className="relative w-full max-w-5xl h-1/2 flex items-center justify-center mt-20">
+            <motion.h2
               style={{
-                opacity: useTransform(smoothProgress1, [0.66, 0.7], [0, 1]),
+                opacity: useTransform(
+                  scrollYProgress,
+                  [0.3, 0.35, 0.4, 0.45],
+                  [0, 1, 1, 0],
+                ),
+                y: useTransform(
+                  scrollYProgress,
+                  [0.3, 0.35, 0.4, 0.45],
+                  [40, 0, 0, -40],
+                ),
               }}
+              className="absolute text-4xl md:text-6xl text-center px-10 leading-tight"
             >
+              pen down your unsaid words into{" "}
+              <span className="font-display text-primary font-extralight">
+                letters
+              </span>
+              .
+            </motion.h2>
+            {/*  Seal */}
+            <motion.h2
+              style={{
+                opacity: useTransform(
+                  scrollYProgress,
+                  [0.45, 0.5, 0.55, 0.6],
+                  [0, 1, 1, 0],
+                ),
+                y: useTransform(
+                  scrollYProgress,
+                  [0.45, 0.5, 0.55, 0.6],
+                  [40, 0, 0, -40],
+                ),
+              }}
+              className="absolute text-4xl md:text-6xl text-center px-10 leading-tight"
+            >
+              seal it{" "}
+              <span className="text-secondary font-display italic font-extralight">
+                secure
+              </span>{" "}
+              and{" "}
+              <span className="text-secondary font-display font-extralight italic">
+                private
+              </span>
+              .
+            </motion.h2>
+            {/*  Send / vault */}
+            <motion.h2
+              style={{
+                opacity: useTransform(
+                  scrollYProgress,
+                  [0.6, 0.63, 0.72, 0.75],
+                  [0, 1, 1, 0],
+                ),
+                y: useTransform(
+                  scrollYProgress,
+                  [0.6, 0.63, 0.72, 0.75],
+                  [40, 0, 0, -40],
+                ),
+              }}
+              className="absolute text-4xl md:text-6xl text-center px-10 leading-tight"
+            >
+              send it to{" "}
               <motion.span
                 className="font-display text-accent"
                 style={{
                   color: useTransform(
-                    smoothProgress1,
+                    scrollYProgress,
                     [0.67, 1],
                     ["var(--color-accent)", "var(--color-neutral)"],
                   ),
                 }}
               >
-                {" "}
+                someone dear
-                or{" "}
               </motion.span>
-              <span className="font-display text-success">
+              <motion.span
-                yourself in the future
+                style={{
-              </span>
+                  opacity: useTransform(scrollYProgress, [0.66, 0.7], [0, 1]),
-              .
+                }}
-            </motion.span>
+              >
-          </motion.h2>
+                <motion.span
-          {/*  Burn */}
+                  className="font-display text-accent"
-          <motion.h2
+                  style={{
-            style={{
+                    color: useTransform(
-              opacity: useTransform(
+                      scrollYProgress,
-                smoothProgress1,
+                      [0.67, 1],
-                [0.75, 0.8, 0.85, 0.9],
+                      ["var(--color-accent)", "var(--color-neutral)"],
-                [0, 1, 1, 0],
+                    ),
-              ),
+                  }}
-              y: useTransform(
+                >
-                smoothProgress1,
+                  {" "}
-                [0.75, 0.8, 0.85, 0.9],
+                  or{" "}
-                [40, 0, 0, -40],
+                </motion.span>
-              ),
+                <span className="font-display text-success">
-            }}
+                  yourself in the future
-            className="absolute text-4xl md:text-6xl text-center px-10 leading-tight"
+                </span>
-          >
+                .
-            and even <span className="font-display text-error">burn it</span> to
+              </motion.span>
-            release the burden.
+            </motion.h2>
-          </motion.h2>
+            {/*  Burn */}
-          {/*  Outro  */}
+            <motion.h2
-          <motion.h2
+              style={{
-            className={
+                opacity: useTransform(
-              "italic absolute text-4xl md:text-6xl text-center px-10 leading-tight"
+                  scrollYProgress,
-            }
+                  [0.75, 0.8, 0.85, 0.9],
-            style={{
+                  [0, 1, 1, 0],
-              opacity: useTransform(smoothProgress1, [0.9, 1], [0, 1]),
+                ),
-              y: useTransform(smoothProgress1, [0.9, 1], [80, 0]),
+                y: useTransform(
-            }}
+                  scrollYProgress,
-          >
+                  [0.75, 0.8, 0.85, 0.9],
-            You've been carrying it long enough.
+                  [40, 0, 0, -40],
-          </motion.h2>
+                ),
-          {/* CTA */}
+              }}
-          <motion.div
+              className="absolute text-4xl md:text-6xl text-center px-10 leading-tight"
-            className={
-              "z-100 absolute -bottom-12 md:bottom-0 font-display flex flex-wrap md:flex-nowrap gap-4 md:gap-12 justify-center"
-            }
-            style={{
-              opacity: useTransform(smoothProgress1, [0.98, 1], [0, 1]),
-              y: useTransform(smoothProgress1, [0.98, 1], [80, 0]),
-              display: useTransform(
-                smoothProgress1,
-                [0.96, 1],
-                ["none", "flex"],
-              ),
-            }}
-          >
-            <button
-              className={
-                "md:opacity-50 hover:opacity-100 btn btn-ghost btn-wide md:btn-xl rounded-full font-extralight md:grayscale hover:grayscale-0 hover:-translate-y-1 transition-all duration-1000"
-              }
-              type={"button"}
-              onClick={() => navigate(ROUTES.ABOUT, { replace: true })}
             >
-              <InfoIcon className={"text-primary"} />
+              and even <span className="font-display text-error">burn it</span>{" "}
-              Tell me More
+              to release the burden.
-            </button>
+            </motion.h2>
-            <button
+            {/*  Outro  */}
+            <motion.h2
               className={
-                "md:opacity-50 hover:opacity-100 btn rounded-full btn-primary btn-wide md:btn-xl md:grayscale hover:grayscale-0 hover:-translate-y-1 transition-all duration-1000"
+                "italic absolute text-4xl md:text-6xl text-center px-10 leading-tight"
               }
-              type={"button"}
+              style={{
-              onClick={() => navigate(ROUTES.ONBOARD, { replace: true })}
+                opacity: useTransform(scrollYProgress, [0.9, 1], [0, 1]),
+                y: useTransform(scrollYProgress, [0.9, 1], [80, 0]),
+              }}
             >
-              I'm ready
+              You've been carrying it long enough.
-            </button>
+            </motion.h2>
-          </motion.div>
+            {/* CTA */}
-        </div>
+            <motion.div
+              className={
+                "z-100 absolute -bottom-12 md:bottom-0 font-display flex flex-wrap md:flex-nowrap gap-4 md:gap-12 justify-center"
+              }
+              style={{
+                opacity: useTransform(scrollYProgress, [0.98, 1], [0, 1]),
+                y: useTransform(scrollYProgress, [0.98, 1], [80, 0]),
+                display: useTransform(
+                  scrollYProgress,
+                  [0.96, 1],
+                  ["none", "flex"],
+                ),
+              }}
+            >
+              <button
+                className={
+                  "md:opacity-50 hover:opacity-100 btn btn-ghost btn-wide md:btn-xl rounded-full font-extralight md:grayscale hover:grayscale-0 hover:-translate-y-1 transition-all duration-1000"
+                }
+                type={"button"}
+                onClick={() => navigate(ROUTES.ABOUT, { replace: true })}
+              >
+                <InfoIcon className={"text-primary"} />
+                Tell me More
+              </button>
+              <button
+                className={
+                  "md:opacity-50 hover:opacity-100 btn rounded-full btn-primary btn-wide md:btn-xl md:grayscale hover:grayscale-0 hover:-translate-y-1 transition-all duration-1000"
+                }
+                type={"button"}
+                onClick={() => navigate(ROUTES.ONBOARD, { replace: true })}
+              >
+                I'm ready
+              </button>
+            </motion.div>
+          </div>
 
-        <div className="relative h-1/4 w-full flex flex-col items-center justify-center pointer-events-none">
+          <div className="relative h-1/4 w-full flex flex-col items-center justify-center pointer-events-none">
-          <motion.div
+            <motion.div
-            className={"z-21 absolute"}
+              className={"z-21 absolute"}
-            style={{
+              style={{
-              opacity: useTransform(
+                opacity: useTransform(
-                smoothProgress1,
+                  scrollYProgress,
-                [0.3, 0.4, 0.5, 0.52],
+                  [0.3, 0.4, 0.5, 0.52],
-                [0, 1, 0.1, 0],
+                  [0, 1, 0.1, 0],
-              ),
+                ),
-              y: useTransform(smoothProgress1, [0.3, 0.45, 0.5], [300, 0, 200]),
+                y: useTransform(
-              scale: useTransform(
+                  scrollYProgress,
-                smoothProgress1,
+                  [0.3, 0.45, 0.5],
-                [0.3, 0.4, 0.5],
+                  [300, 0, 200],
-                [1, 1, 0.6],
+                ),
-              ),
+                scale: useTransform(
-            }}
+                  scrollYProgress,
-          >
+                  [0.3, 0.4, 0.5],
-            <div className="mockup-phone w-[75vw] border-primary">
+                  [1, 1, 0.6],
-              <div className="mockup-phone-camera"></div>
+                ),
-              <div className="mockup-phone-display">
+              }}
-                <img alt="letter" src="/screenshots/letter.webp" />
+            >
+              <div className="mockup-phone w-[75vw] border-primary">
+                <div className="mockup-phone-camera"></div>
+                <div className="mockup-phone-display">
+                  <img alt="letter" src="/screenshots/letter.webp" />
+                </div>
               </div>
-            </div>
+            </motion.div>
-          </motion.div>
+            {/*  Envelope */}
-          {/*  Envelope */}
+            <motion.div
-          <motion.div
+              className="absolute scale-50 md:scale-80 z-10"
-            className="absolute scale-50 md:scale-80 z-10"
+              style={{
-            style={{
+                opacity: useTransform(
-              opacity: useTransform(
+                  scrollYProgress,
-                smoothProgress1,
+                  [0.4, 0.45, 0.5, 0.7, 0.9, 1],
-                [0.4, 0.45, 0.5, 0.7, 0.9, 1],
+                  [0, 0.6, 1, 1, 0.3, 0],
-                [0, 0.6, 1, 1, 0.3, 0],
+                ),
-              ),
+                y: useTransform(scrollYProgress, [0.45, 0.5, 1], [600, 200, 0]),
-              y: useTransform(smoothProgress1, [0.45, 0.5, 1], [600, 200, 0]),
+              }}
-            }}
+            >
-          >
+              <EnvelopeReveal
-            <EnvelopeReveal
+                isInteractive={false}
-              isInteractive={false}
+                ignite={ignite}
-              ignite={ignite}
+                recipient={recipient}
-              recipient={recipient}
+                date={formatDate(new Date().toISOString())}
-              date={formatDate(new Date().toISOString())}
+                onRevealComplete={() => {}}
-              onRevealComplete={() => {}}
+                isFlip={isEnvelopeFlipped}
-              isFlip={isEnvelopeFlipped}
+                openFlap={flapOpen}
-              openFlap={flapOpen}
+              />
+            </motion.div>
+            {/*  Saajan */}
+            <motion.div
+              className="fixed bottom-0 z-10 font-sans -mb-6 scale-85 md:scale-100 md:mb-0"
+              style={{
+                opacity: useTransform(
+                  scrollYProgress,
+                  [0.98, 0.995, 1],
+                  [0, 0.5, 1],
+                ),
+                y: useTransform(scrollYProgress, [0.98, 1], [50, -10]),
+              }}
+            >
+              <Saajan
+                message={
+                  "I think we forget things\nif there is nobody to tell them."
+                }
+                position={"top"}
+              />
+            </motion.div>
+            {/*  Orb */}
+            <motion.div
+              className="w-48 z-100 h-48 rounded-full blur-3xl opacity-20"
+              transition={{
+                backgroundColor: { ease: "easeIn", duration: 2 },
+              }}
+              style={{
+                backgroundColor: useTransform(
+                  scrollYProgress,
+                  [0.45, 0.5, 0.7, 0.75, 1],
+                  [
+                    "var(--color-primary)",
+                    "var(--color-secondary)",
+                    "var(--color-accent)",
+                    "var(--color-success)",
+                    "var(--color-error)",
+                  ],
+                ),
+                scale: useTransform(scrollYProgress, [0, 1], [0.6, 2.5]),
+              }}
             />
-          </motion.div>
+            <div className="absolute border border-primary/5 w-64 h-64 rounded-full backdrop-blur-[1px]" />
-          {/*  Saajan */}
+          </div>
-          <motion.div
-            className="fixed bottom-0 z-10 font-sans -mb-6 scale-85 md:scale-100 md:mb-0"
-            style={{
-              opacity: useTransform(
-                smoothProgress1,
-                [0.98, 0.995, 1],
-                [0, 0.5, 1],
-              ),
-              y: useTransform(smoothProgress1, [0.98, 1], [50, -10]),
-            }}
-          >
-            <Saajan
-              message={
-                "I think we forget things\nif there is nobody to tell them."
-              }
-              position={"top"}
-            />
-          </motion.div>
-          {/*  Orb */}
-          <motion.div
-            className="w-48 z-100 h-48 rounded-full blur-3xl opacity-20"
-            transition={{
-              backgroundColor: { ease: "easeIn", duration: 2 },
-            }}
-            style={{
-              backgroundColor: useTransform(
-                smoothProgress1,
-                [0.45, 0.5, 0.7, 0.75, 1],
-                [
-                  "var(--color-primary)",
-                  "var(--color-secondary)",
-                  "var(--color-accent)",
-                  "var(--color-success)",
-                  "var(--color-error)",
-                ],
-              ),
-              scale: useTransform(smoothProgress1, [0, 1], [0.6, 2.5]),
-            }}
-          />
-          <div className="absolute border border-primary/5 w-64 h-64 rounded-full backdrop-blur-[1px]" />
         </div>
-      </div>
+      </section>
-    </section>
+    </ReactLenis>
   );
 }

scripts/run-e2e.sh

@@ -55,6 +55,18 @@ until $CONTAINER_BIN exec "$DB_NAME" pg_isready -U "${DB_USER:-test}" >/dev/null
 done
 
 export PIKU_ENV_FILE="$ENV_FILE"
+
+# NOTE: When running in Gitea Actions (within container), We must ponint DB and mail to the internal docker host instead.
+if [ "$GITEA_ACTIONS" = "true" ]; then
+    sudo apt-get update && sudo apt-get install -y iproute2
+    # Sample: "default via <internal docker host IP> dev <network interface> proto dhcp src <IP> metric 100"
+    HOST_IP=$(ip route show default | awk '/default/ {print $3}')
+    echo "Running on Gitea. Internal Docker host... $HOST_IP"
+
+    export DB_HOST=$HOST_IP
+    export EMAIL_HOST=$HOST_IP
+fi
+
 echo "Starting Backend..."
 mkdir -p ./tmp/logs
 (