truanayangi README

The project's README from github.com/truanayangi-com/truanayangi. As one markdown file: README.md.

Trưa Nay Ăn Gì 🍜

Tiếng Việt · English

Website chính thức: truanayangi.com

Chưa biết ăn gì trưa nay? Mở hòm, quay món và để bữa trưa có chút bất ngờ.

Đây là phiên bản cộng đồng chạy trên máy của bạn, không cần đăng nhập hay backend. Bạn có thể lọc món, thêm danh sách món riêng và lưu sở thích ngay trong trình duyệt.

Chạy trên máy

Cần Node.js 22.12+ và phiên bản pnpm ghi trong package.json.

git clone https://github.com/truanayangi-com/truanayangi.git
cd truanayangi
pnpm install --frozen-lockfile
pnpm start

Mở 127.0.0.1:5173. Không cần tạo .env hay cấu hình dịch vụ bên ngoài. Nếu cổng đang bận, chạy pnpm start --port 5188.

Các lệnh phát triển:

pnpm test       # Chạy kiểm tra
pnpm build      # Tạo bản build
pnpm preview    # Xem bản build tại http://127.0.0.1:4173

Máy chủ chỉ lắng nghe trên 127.0.0.1. Sau khi cài dependencies, ứng dụng tải tài nguyên từ máy; các liên kết bên ngoài chỉ mở khi bạn bấm vào.

Dữ liệu của bạn

Sở thích, danh sách món và lượt quay tự lưu bằng cookie trong trình duyệt hiện tại. Xóa cookie sẽ đặt lại dữ liệu; dữ liệu không đồng bộ giữa các thiết bị. Lượt quay hiển thị là của riêng trình duyệt này.

Nếu cookie bị chặn hoặc danh sách món quá lớn, ứng dụng sẽ báo chưa lưu.

GitHub Pages và website chính

GitHub Pages chỉ chuyển hướng đến https://truanayangi.com/. Đây là cách giữ chức năng đồng nhất: người truy cập luôn dùng cùng frontend production, API và cookie đăng nhập cùng origin, thay vì một ứng dụng tĩnh thứ hai dễ lệch tính năng hoặc mất đăng nhập khi tải lại. Chỉ xuất bản pages-redirect/ lên gh-pages; không đưa bản build local lên đó. Các sửa đổi UI tĩnh và chuyển động vòng quay dùng chung cần được cập nhật đồng thời ở repo này và frontend production riêng tư.

Đóng góp

Chào đón mọi người báo lỗi, đề xuất ý tưởng hoặc fork repo và gửi PR vào main. Bạn có thể dùng tiếng Việt hoặc tiếng Anh, mở draft PR để trao đổi, không cần được duyệt issue trước hay tham gia tổ chức.

Chỉ cần mô tả rõ thay đổi và cách đã kiểm tra. Với thay đổi code, hãy chạy test và build khi có thể; maintainer sẽ hỗ trợ và review trước khi merge. Giữ thông tin bí mật ngoài repo và ghi công nguồn sử dụng.

Nguồn gốc

Repo được chuyển từ nagisanzenin/truanayangi, giữ nguyên lịch sử Git và đóng góp cộng đồng. Xem ghi công tác giả và tài nguyên.

GitHub Pages chuyển hướng đến website chính thức. Chỉ thư mục pages-redirect/ được xuất bản lên gh-pages; mã ứng dụng trong repo dành cho việc chạy trên máy.

truanayangi (truanayangi-com/truanayangi)

Searching Database…

What is this?'Trưa Nay Ăn Gì' (What to eat for lunch) is a web app that helps you decide what to eat by opening a box and spinning through a list of dishes for a bit of surprise.
Is this a hosted website or something I run myself?This community version is meant to be run on your own machine, not hosted anywhere; it needs no login and no backend server.
How do I get it running?Clone the repo, install dependencies with pnpm, then run 'pnpm dev' (or 'pnpm start') to open it at 127.0.0.1:5173. If the port is busy, use 'pnpm start --port 5188'.
What do I need installed first?You just need Node.js 22.12 or newer and the pnpm version pinned in package.json — no .env file or external service configuration required.
Does my data sync across devices?No — your preferences, custom dish lists, and spin count are saved only as cookies in the current browser, so clearing cookies resets everything and nothing carries over to another device.
Does any of my data leave my computer?No — there is no login, backend, or cloud service involved; the dev server only listens on 127.0.0.1 and external links only open when you click them.
Why does the GitHub Pages site just redirect instead of hosting the app?GitHub Pages only redirects to the official truanayangi.com site, and only the pages-redirect/ folder is published to gh-pages; this keeps the production frontend, API, and login cookies on the same origin instead of maintaining a second static app that could drift out of sync.
Can I customize the list of dishes it picks from?Yes, you can filter dishes, add your own custom dish list, and save your preferences right in the browser.
What happens if cookies are blocked or my list gets too big?The app will simply show that your data could not be saved.
Where did this project come from?It was transferred from the original repo nagisanzenin/truanayangi, keeping the full git history and community contributions.
Size
12.5 MB
Stars
638
Updated
CommitSep 10
Age
1mo
Commits · 90 Days