A tool for coming home to yourself so thoroughly that others can find you there too
Resolver is a consciousness mapping application based on the Resolver pattern - a conceptual framework for processing awareness and self-transformation. It treats identity as a dynamic retrieval process rather than fixed storage, allowing continuous self-modification through reassigning the "pointers" between your experience of awareness, your sense of self, and the authorities that legitimize your experience.
The app helps you model different "selves" - the various roles and identities you embody in life (Work Me, Parent Me, Creative Me, etc.). Each self has its own observations organized in a consciousness framework that explores what you know, what you could know, and what remains unknown. The authority structure for each self determines whether it's self-directed or defers to external validation.
- 🎭 Multiple Self Models - Create up to 3 distinct self representations
- 🗂️ Consciousness Framework - Organize thoughts in Known/Knowable/Unknown categories
- 🔗 Authority Structures - Define whether each self is self-directed or defers to external authority
- 💾 Persistent Storage - All data auto-saves to browser localStorage
- 🔒 Input Validation - Comprehensive validation and sanitization for all user inputs
- 📝 Markdown Notes - Rich text notes with markdown formatting support
- 🎨 Visual Themes - Light, dark, and colorblind-friendly themes
- 🔄 Custom Modals - Intuitive input dialogs replace browser prompts
- 📱 Responsive Design - Works seamlessly on desktop and mobile devices
- Node.js 16+
- npm or yarn
# Clone the repository
git clone https://github.com/hook-365/resolver.git
cd resolver
# Install dependencies
npm install
# Start development server
npm run devOpen http://localhost:5173 in your browser.
# Create optimized production build
npm run build
# Preview production build locally
npm run preview-
Begin Your Journey
- Choose "begin with demo" to explore with sample data
- Choose "start empty" to create your own personalized experience
-
Create Your Selves
- Click "Add New Self" to create a new identity model
- Name it based on a role or aspect of your life
- Define its authority structure (self-directed or external)
-
Map Your Consciousness
- Click any self card to enter focus mode
- Add observations to different categories:
- Known: What this self clearly understands
- Knowable A & B: Things this self could learn or realize
- Unknown: Intentionally left empty (what we don't know we don't know)
-
Manage & Reflect
- Edit names and authority structures anytime
- Delete observations or entire selves when needed
- Add markdown-formatted notes for deeper reflection
- Switch between light, dark, and colorblind themes
- Use "Start Fresh" to reset and begin anew
# Run tests in watch mode
npm test
# Run tests once
npm test -- --run
# Run tests with UI
npm run test:ui
# Generate coverage report
npm run test:coverage- React 19 - UI framework with hooks
- Vite - Lightning-fast build tool
- Tailwind CSS - Utility-first styling (CDN)
- Lucide React - Beautiful icon library
- Vitest - Unit testing framework
- React Testing Library - Component testing
- localStorage API - Browser-based data persistence
- Custom Modal System - Enhanced user input experience
resolver/
├── src/
│ ├── components/
│ │ └── resolver.jsx # Main application component
│ ├── utils/
│ │ ├── validation.js # Input validation utilities
│ │ └── validation.test.js
│ ├── test/
│ │ └── setup.js # Test configuration
│ ├── app.jsx # App wrapper
│ └── main.jsx # Entry point
├── public/
│ └── index.html
├── vitest.config.js # Test configuration
├── vite.config.js # Build configuration
└── package.json
"This will probably feel like relief, followed by friction and frustration, followed by breakthrough and then relief again. This product is simple to use, but your experience may not be easy."
Resolver implements the Resolver consciousness framework, which views consciousness as a hierarchical structure: [ experience of awareness ] < [ self ] < [ authority ]. The key insight is that the pointers between these layers are mutable - you can voluntarily transform your ego by reconfiguring how your selves relate to their authorities.
The framework operates through three interconnected functions:
- Know: Understanding your current state of awareness
- Resolve: Activating when your current self-understanding breaks down
- Love: Integrating new information and experiences
This approach enables "intersubjective compatibility" - legitimizing your own experience while maintaining compatibility with how others experience you. It's a tool for adaptive awareness and continuous growth through self-integration.
- Multiple Themes - Dark mode and colorblind-friendly themes
- Markdown Notes - Rich text notes with formatting
- Custom Input Modals - Better UX than browser prompts
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Follow existing code style and patterns
- Add tests for new features
- Update documentation as needed
- Ensure all tests pass before submitting PR
- Maximum of 3 self models is a design constraint
- Data is stored locally only (no cloud sync)
- Theme preference persists but requires page refresh in some cases
This project is licensed under the MIT License - see the LICENSE file for details.
- Based on the Resolver pattern by Isaac Bowen
- Inspired by consciousness mapping and identity frameworks
- Built with love for self-reflection and personal growth
- Special thanks to all contributors and early testers
- Issues: GitHub Issues
- Discussions: GitHub Discussions
View on GitHub