Your Success List, Elevated.
Elevare is not just a task manager. It's a productivity coach that helps you cut through noise, focus on the vital few, and build momentum toward extraordinary results.
Elevare is a minimalist productivity app designed around one core principle: extraordinary results come from narrowing your focus. Unlike endless to-do lists, Elevare helps you cut through the noise by identifying your ONE most important task each day, the single domino that, once knocked down, makes everything else easier or unnecessary.
- Go Small - Doing the most important thing is always the most important thing.
- Domino Effect - Success builds sequentially, one meaningful task at a time.
- Success Lists ≠ To-do Lists - Most to-dos are noise. Elevare guides you toward the vital few that truly matter.
- Extraordinary > Busy - Don't focus on doing more; focus on doing what matters most.
"Success is about doing the right thing, not about doing everything right."
🎯 Daily Focus — Commit to your single most important task each day.
✅ Completion & Reflection — Mark tasks as complete and reflect to build awareness and growth.
📊 Archive & Progress — See your journey unfold through archived tasks and reflections.
🔐 Secure Authentication — Built with NextAuth.js + Prisma for safe, private accounts, Limit API rate of 10 calls per day.
🏷️ Tags — Organize tasks by life area (#Health, #Work, #Relationships).
🏆 Gamification (Planned) — Rewards and streaks to keep you consistent.
Task Suggestion Mode: When you have existing tasks, Elevare analyzes them and suggests the ONE most important task for today.
Exploration Mode: When you need guidance without existing tasks, Elevare acts as a productivity coach to help you discover your ONE Thing.
Mode selection is automatic: if currentTasks are provided, Elevare runs Task Suggestion Mode. If not, it enters Exploration Mode.
- Inner Clarity Framing: Reflective questions that tap into your motivation and identity, not just tasks. This helps you connect with your deeper purpose before taking action.
- Progressive Narrowing: Ranked suggestions that funnel you toward the most impactful action. This prevents overwhelm and forces you to focus on high-leverage activities.
- Emotion-Action Links: Connect tasks to confidence, progress, and self-identity outcomes. This makes action sticky and habit-forming by linking behavior to identity.
- Extreme 80/20 Principle: Focus on the 0.8% of tasks that create 80% of results.
- Node.js 18+
- npm or yarn
- Google AI API key (for Gemini integration)
-
Clone the repository
git clone https://github.com/Gojer16/elevare-ai-assistant.git cd elevare-ai-assistant -
Install dependencies
npm install
-
Set up environment variables
cp .env.example .env
Add your Google AI API key:
GOOGLE_API_KEY=your_api_key_here PORT=5000 NODE_ENV=development
-
Build and start the server
npm run build npm start
Or for development:
npm run dev
-
Test the API
curl http://localhost:5000 # Should return: "Welcome to the Elevare AI Backend!"
http://localhost:5000/api/ai
Get AI-powered suggestions for your ONE Thing.
Request Body:
{
"prompt": "I want to learn Python",
"currentTasks": [
{
"id": "1",
"name": "learning python"
},
{
"id": "2",
"name": "exercise"
},
{
"id": "3",
"name": "reading fiction"
}
]
}Response Examples:
Task Suggestion Mode:
{
"success": true,
"mode": "task-suggestion",
"suggestion": {
"name": "Master Python fundamentals through building a tiny project",
"rationale": "Learning Python will give you the foundation to tackle any programming challenge. Building something real will make the concepts stick and give you immediate confidence in your abilities."
}
}Exploration Mode:
{
"success": true,
"mode": "exploration",
"exploration": {
"type": "brainstorm",
"content": "Here are some HIGH-LEVERAGE actions you could take for your ONE Thing today:",
"suggestions": [
"Build a tiny Python project that solves a real problem you have (start with 30 minutes)",
"Master the ONE Python concept that unlocks 80% of what you want to build",
"Fix the ONE critical bug that's been blocking your progress",
"Create a simple script that automates something you do manually every day"
],
"reflection_question": "What would make learning Python feel most meaningful to you right now — building something that solves a real problem, mastering the fundamentals, or tackling challenging problems?",
"progressive_path": "Start with the tiny project to build confidence and momentum, then layer in the concept mastery and problem-solving as you gain experience.",
"identity_impact": "Completing a tiny Python project this week will immediately give you confidence and proof that you're becoming a Python builder who can solve real problems."
}
}Submit feedback on AI suggestions to improve future recommendations.
Request Body:
{
"suggestion": {
"name": "Write the core function for your highest-priority feature",
"rationale": "This will unlock 80% of your functionality"
},
"feedback": "helpful"
}Response:
{
"success": true,
"message": "Feedback received."
}npm run build # Build TypeScript to JavaScript.
npm start # Start production server.
npm test # Run test suite.
npm run test:watch # Run tests in watch mode.| Variable | Description | Default |
|---|---|---|
GOOGLE_API_KEY |
Google AI API key (required) | - |
PORT |
Server port | 5000 |
NODE_ENV |
Environment (development/production/test) | development |
DB_FILE_DEV |
Development database file | elevare_dev.db |
DB_FILE_PROD |
Production database file | elevare_prod.db |
DB_FILE_TEST |
Test database file | :memory: |
The application uses SQLite with better-sqlite3 for data persistence. The database is automatically created and initialized on first run.
Tables:
feedback- Stores user feedback on AI suggestions
# Run all tests
npm test
# Run tests in watch mode
npm run test:watch
# Run specific test file
npm test -- explorationService.test.ts- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
For support, email [email protected] or join our Discord community.
Elevare: Your Success List, Elevated. 🚀