Navigate the universe of ideas. Your AI-powered brainstorming partner for turning a single word into a world of possibilities.
Note
Project Status: This project is an active submission for the Kiro.dev Hackathon, evolving from an initial MVP created for the OpenAI gpt-oss Hackathon. The full submission history is detailed at the end of this document.
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-ossmodels, 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.
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 |
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:
pnpm install
-
Set up environment variables: Create a
.env.localfile 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.localfile. -
Run the development server:
pnpm dev
Open http://localhost:3000 in your browser to see the result.
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.
This project is an evolving entry for two sequential hackathons. I plan to continue developing it long after the competitions are over. To ensure fair judging, each submission is preserved in a permanent Git hash and has its own immutable deployment link.
This submission features user authentication, session persistence, and a development workflow powered by Kiro.dev.
The initial MVP was a stateless, client-side focused application built in a 48-hour sprint to demonstrate the core mind-mapping experience with gpt-oss models.