Skip to content

happydeveloper/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:

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 API keys:

# Get your OpenRouter API key from https://openrouter.ai/
OPENROUTER_API_KEY=your_openrouter_api_key_here

# Get your Gemini API key from https://aistudio.google.com/app/apikey
GOOGLE_GENERATIVE_AI_API_KEY=your_gemini_api_key_here
  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.

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 93.3%
  • CSS 4.8%
  • JavaScript 1.9%