Chronicle - World News

Explore the planet with Gemini: real news, real history, one click.

Comment

Chronicle – Real World News

Inspiration

Staying informed shouldn’t require jumping between dozens of sites or reading endless headlines that lack global context. Most news platforms show information, but not understanding. I wanted to build something that makes world events easier to follow, compare, and contextualize.

Gemini 3 inspired me because it offered a way to turn raw headlines into clear summaries and insights. I wanted to see how far I could push an AI-augmented news experience built entirely on the frontend.

What it does

Chronicle – Real World News is a lightweight AI-powered platform that helps users:

  • Browse real-time global news using the World News API
  • See country information, flags, and metadata via the REST Countries API
  • Receive clear AI-generated summaries of headlines using Gemini
  • Browse news through a clean, fast, minimal UI

Chronicle aims to turn scattered headlines into structured understanding.

How we built it

The project was built using:

  • React + TypeScript for a structured, maintainable frontend
  • Vite for fast builds and development
  • Gemini AI Studio for summarization and contextual enhancement
  • World News API for live international news
  • REST Countries API for geographic context
  • Custom hooks and TypeScript types to unify the data layer
  • A simple, modular UI built for clarity

The entire project was built solo during the hackathon.

Challenges I ran into

  • Designing reliable prompts so Gemini outputs consistent summaries
  • Handling different levels of data availability across countries
  • Some countries do not have full real-time coverage in the World News API
  • Merging country metadata with news articles cleanly
  • Ensuring good performance while making multiple API requests
  • Debugging TypeScript issues when connecting several external APIs
  • Time Constraint of 24 hours to make something challenging and innovative as a solo dev

Accomplishments that I'm proud of

  • Built a complete AI-enhanced news explorer solo
  • Integrated multiple APIs with full type safety
  • Created a simple, fast interface that organizes complex information
  • Designed an AI summarization pipeline that works reliably with live news data
  • Turned a simple concept into a demo-able tool within the hackathon timeframe

What I learned

  • Structuring prompts for consistency with Gemini and building fast with Gemini AI studio
  • Handling multi-API data flows in a frontend-only project
  • Improving TypeScript type modeling and component design
  • Learning how to build practical AI-assisted features into real applications
  • Understanding the limitations of different news APIs and how to work around them

Limitations

  • Some countries have limited or no live news coverage through World News API
  • Currently, live updates are primarily available for the US and a few other major regions
  • Map and news integration can be slow if many API requests happen simultaneously

What's next for Chronicle – World News

  • Add more news APIs to expand global coverage
  • Improve summarization with automatic multi-source comparisons
  • Build a more visual UI with WEATHER/WIND FLOW live with a meteoroligcal data api
  • Add topic filtering, categories, and user preferences
  • Explore adding trade routes visualization, sea routes, zoomable view into cities

Built With

Share this project:

Updates