Skip to content

hyusap/deconstructor

Repository files navigation

Word Deconstructor

A beautiful and interactive web application that deconstructs words into their meaningful parts and explains their etymology. Built with Next.js, React Flow, and powered by AI.

Features

  • 🔍 Interactive word analysis
  • 🌳 Beautiful visualization of word components using React Flow
  • 📚 Detailed etymology and meaning breakdowns
  • 🎨 Dark mode
  • ⚡ Real-time updates and animations
  • 🧠 AI-powered word deconstruction using OpenRouter API

Prerequisites

Before you begin, ensure you have:

  • Node.js 18+ installed
  • An OpenRouter API key (get one at OpenRouter)

Getting Started

  1. Clone the repository:
git clone https://github.com/hyusap/deconstructor.git
cd deconstructor
  1. Install dependencies:
bun install
  1. Set up environment variables:
cp example.env .env.local

Then edit .env.local and add your OpenRouter API key.

  1. Run the development server:
bun dev
  1. Open http://localhost:3000 with your browser to see the result.

How It Works

The Word Deconstructor breaks down words into their constituent parts:

  1. Enter any word in the input field
  2. The AI analyzes the word's etymology and components
  3. A beautiful graph visualization shows:
    • Individual word parts
    • Their origins (Latin, Greek, etc.)
    • Meanings of each component
    • How components combine to form the full word

Tech Stack

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.