GitHub - marcelocra/concept-compass: Navigate the universe of ideas. Your AI-powered brainstorming partner for turning a single word into a world of possibilities.

Concept Compass

Navigate the universe of ideas. Your AI-powered brainstorming partner for turning a single word into a world of possibilities.

✨ What It Does

Concept Compass is an interactive web application that transforms any keyword or idea into a dynamic, explorable mind map. Instead of a static list of suggestions, it provides a visual graph of interconnected concepts, allowing you to navigate and expand your ideas in any direction, infinitely.

Plant a Seed: Start with a single concept (e.g., "The Future of AI Assistants").
Grow the Universe: Powered by OpenAI's gpt-oss models, it generates a rich mind map of related ideas.
Explore Infinitely: Click any node to make it the new center of the universe, revealing ever-deeper layers of thought in a seamless partnership between human curiosity and AI.

🛠️ Tech Stack & Architecture

Concept Compass is built with a modern, high-performance tech stack. The entire development process for new features is orchestrated using a spec-driven workflow within the Kiro.dev IDE.

Category	Technology
Framework	Next.js 15 (App Router & Turbopack)
UI	React 19, TypeScript
Styling	Tailwind CSS, shadcn/ui
AI Model	OpenAI `gpt-oss-120b` via OpenRouter.ai
Visualization	React Flow
Authentication	Clerk
Database	Supabase (Postgres), Drizzle ORM
Testing	Vitest, React Testing Library
Deployment	Vercel

🏃 Getting Started

To run this project locally, follow these simple steps:

Clone the repository:

git clone https://github.com/marcelocra/concept-compass.git
cd concept-compass

Install dependencies using pnpm:
Set up environment variables: Create a .env.local file in the root of the project by copying the example file:
```
cp .env.example .env.local
```
Now, fill in the required API keys and environment variables in your new .env.local file.
Run the development server:

Open http://localhost:3000 in your browser to see the result.

🛣️ What's Next for Concept Compass

This project is more than a hackathon entry; it's the foundation for a comprehensive creative suite. The roadmap includes:

Branching History & Exploration Trees: Implement a system to go back and forth in the graph of ideas, allowing a user to explore multiple creative paths from a single starting point.
"Deep Dive" Elaboration Engine: Add a feature to expand the content of any node, generating a detailed summary or explanation of that specific concept.
Actionable Content Generation: Create a feature where a user can select a path of nodes and have the AI generate practical content from it, such as a blog post outline or a series of social media posts.