hackernews-cn  by ViggoZ

HackerNews client for translated tech news

created 4 months ago
301 stars

Top 89.6% on sourcepulse

GitHubView on GitHub
Project Summary

This project provides a Chinese version of Hacker News, automatically translating popular English tech news and discussions into Chinese. It targets developers and tech enthusiasts who want to stay updated on global tech trends without language barriers, offering a modern, fast, and user-friendly interface.

How It Works

The application leverages a modern Next.js 14 stack for both frontend and backend API routes. It synchronizes with Hacker News content hourly, using the OpenAI API for intelligent translation of article titles and bodies. The UI is built with Tailwind CSS and shadcn/ui, ensuring a responsive and clean user experience. Prisma acts as the ORM for PostgreSQL, managing data persistence.

Quick Start & Requirements

  • Install dependencies: pnpm install
  • Initialize database: pnpm prisma db push
  • Start development server: pnpm dev
  • Requires Node.js 18+, pnpm 8+, and an OpenAI API key. PostgreSQL is recommended for local development.

Highlighted Details

  • Real-time synchronization with Hacker News content.
  • High-quality translation of titles and bodies via OpenAI API.
  • Support for various content types: Latest, Top, Ask HN, Show HN, Jobs.
  • Modern UI with responsive design and dark mode support.

Maintenance & Community

The project is maintained by ViggoZ. Feedback and contributions are welcomed via GitHub Issues or direct contact via Twitter (@decohack) or email.

Licensing & Compatibility

The project is released under the MIT License, permitting commercial use and integration with closed-source projects.

Limitations & Caveats

The core functionality relies on the availability and cost of the OpenAI API. While deployed on Vercel, specific Vercel features like Cron Jobs and Postgres are recommended for optimal automated updates.

Health Check
Last commit

4 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
37 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.