CodeForge
← All projects

LINE Mini App · AI Product

AI tarot reading app built inside LINE

A tarot reading app that runs as a LINE Mini App — a Claude-powered reading engine, a hand-built card-fan picker, membership and credits, and a 4-tab admin back office, all in one system.

Next.js 16React 19TypeScriptTailwind CSS v4Claude Sonnet 4.6MySQLLINE LIFF SDKRadix UI

78

Card full tarot deck

4

Reading modes

3

AI reader personalities

Overview

Built with Next.js App Router end to end — frontend and API in one project — and shipped as a LINE Mini App (LIFF), so users open it straight from LINE with no separate install. User accounts, credit balances, and reading history all live in MySQL with a schema that creates and migrates itself on deploy.

Reading engine

AI

Full 78-card deck

Major Arcana plus Cups, Pentacles, Swords, and Wands — separate upright/reversed meanings and category-specific keywords for love, career, and money.

AI

4 reading formats

Ask-a-question spreads (1/3/5/10 cards including Celtic Cross), a daily card across 12 life categories, a monthly card, and full history.

AI

3 reader personalities

Gentle, serious, or playful — each with its own system prompt controlling tone, streamed live from Claude Sonnet 4.6 with guardrails against invented meanings.

Custom interaction

Frontend

Hand-built card-fan picker

A Canvas 2D card fan with real momentum physics and snap-back — no carousel library. Card backs are drawn entirely in code and pre-rendered to a cache to cut per-frame cost.

Frontend

Feedback loop

Haptic feedback, page transitions, and a 1–5 star rating after every reading feed straight back into the quality-review pipeline.

Identity & monetization

Auth

LINE LIFF login

Automatic sign-in inside the LINE app — the server verifies the ID token directly against LINE's endpoint before opening a session, never trusting the client alone. Sessions are HMAC-SHA256 signed, httpOnly, and compared in constant time.

Revenue

Credits & promo codes

A per-user credit ledger (purchase / spend / bonus / manual adjustment / refund / code redemption) with atomic, row-locked debits so simultaneous requests can't double-spend. Promo and gift codes carry their own quota, expiry, and per-user redemption lock.

Admin back office

Ops

4-tab dashboard

Readings (with star ratings and full transcripts), Users (profile + manual credit adjustment), Payments (revenue + full ledger), and Codes (issue / enable / disable) — with live totals computed per tab.

Shipped

  • AI reading engine, LINE auth, credits + promo codes, and the admin dashboard — running end to end

Next phase

  • Real payment gateway (PromptPay / KBank) — the top-up flow and UI are already built and waiting on the provider integration
  • "Events" (mission-based free credits) and "Community" (share readings) — menu slots are already reserved

Ready to build something?

We take on a limited number of projects per quarter. Let's talk before the spots fill up.