Build your first project with a code agent
A practical guide to building a live news newspaper with the HackerNews API, published on GitHub Pages.
What you'll build
A static news newspaper that fetches the top 10 Hacker News stories in real time and renders them as a newspaper page: main headline, articles section, and numbered listing. All powered by the HackerNews public API (no authentication), published on your GitHub Pages.
The project is the vehicle. What you'll actually learn is the AI-Native Engineering workflow: context, planning with ROADMAP.md and DEV_PLAN.md, phased execution, and publishing.
This is the project you'll build
The component below fetches the HackerNews API right now and renders the stories in the newspaper layout you'll create from scratch.
Prerequisites
- GitHub account
- AI-powered development tool configured: AI-integrated IDE (Cursor, Windsurf), AI CLI for the terminal (Claude Code, OpenCode), or IDE assistant (Copilot, etc.)
- LLM configured in your tool (Claude, GPT, Gemini, etc.)
Your progress
Set the ground
Create the repository on GitHub, clone it in the terminal, open it in your chosen tool, and install the GitHub CLI.