docs: frontend/README.md is the default create-next-app boilerplate
Đánh giá
- Độ khó
- 2/5
- Thời gian dự kiến
- 1-3 giờ
- Mức phù hợp với người mới
- 85/100
- Loại issue
- Tài liệu
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- next.js, react, tailwindcss, typescript
- Lĩnh vực
- documentation, frontend, internationalization
Hướng nghiên cứu
Cập nhật frontend/README.md thay vì README ở root hoặc backend. Trước tiên, hãy kiểm tra thiết lập frontend, các script, bố cục dự án, NEXT_PUBLIC_API_URL, cấu trúc en/hi của next-intl và cách sử dụng shadcn, sau đó thay thế nội dung của create-next-app bằng hướng dẫn dành riêng cho dự án. Công việc được xem là hoàn tất khi những người đóng góp frontend mới có thể cài đặt các điều kiện tiên quyết, cấu hình URL API, chạy ứng dụng, hiểu bố cục và i18n, cũng như sử dụng các component shadcn.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Problem
frontend/README.md is still the default create-next-app template. It has only
generic Next.js content (Getting Started with app/page.tsx, next/font/Geist,
"Deploy on Vercel") and nothing specific to Perspective — no actual stack, no local
setup, no NEXT_PUBLIC_API_URL, no next-intl (en/hi) i18n structure, no project
layout. It's misleading for new frontend contributors (e.g. it points to Vercel,
while this project deploys the backend to Hugging Face).
Relation to existing work
Distinct from #126 and PR #132, which cover the root README, the backend
README, and .env.example files — neither touches frontend/README.md.
Proposed fix
Replace the boilerplate with frontend-specific docs: tech stack (Next.js 15 App
Router, React 19, TS, Tailwind + shadcn/ui, next-intl), prerequisites + setup,
NEXT_PUBLIC_API_URL, npm scripts, i18n structure (en/hi), project layout, shadcn usage.
I'd like to work on this — could it be assigned to me?
- Ngôn ngữ chính
- TypeScript
- Star
- 58
- Fork
- 90
- Merge trung bình
- 11 giờ 51 phút
- Pull request đã merge (30 ngày)
- 3
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của AOSSIE-Org/Perspective
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 83/100
AOSSIE-Org/Perspective#191 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 85/100
AOSSIE-Org/Perspective#190 ·
-
[BUG]: Missing input validation in URlRequest and ChatQuery causes 500 crashes and wasteful scraper executionCó thể đã có người làm @agarwalpranav0711 đã nhận 25 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
AOSSIE-Org/Perspective#178 ·
-
[BUG]: chunk_rag_data crashes with ValueError when perspective is a dict, silently dropping RAG vector storageCó thể đã có người làm @agarwalpranav0711 đã nhận 36 ngày trước. Đang mởbug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
AOSSIE-Org/Perspective#175 ·
-
[BUG]: Scraper passes headers as query params in requests.get (User-Agent never sent)Có thể đã có người làm @Th-Shivam đã nhận 50 ngày trước. Đang mởbug
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 92/100
AOSSIE-Org/Perspective#161 · 1 bình luận ·
Tất cả issue của AOSSIE-Org/Perspective
Issue tương tự
-
documentation lens:human needs-triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 73/100
thebristolsound/birdbrain#2246 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
-
A voting window past about 69.9 million hours stores a deadline that reads back as no deadlineĐang mởbug ready-for-human
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
BoardGamesEmpire/board-games-empire-backend#1452 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
good first issue stretch
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
Maintainer thường phản hồi trong vòng 1 ngày