Manaboodle - Modern Blog & Content Platform
A Next.js-powered blog and content platform featuring curated articles across multiple categories with a focus on education, technology, and creative projects.
🚀 Live Site
Visit: www.manaboodle.com
✅ Current Status
Working Features
- Multi-Category Content: Case Studies, Concepts, Projects, and Random thoughts
- Tools Section: Interactive tools for writers and creators
- Read Time Calculator - Calculate reading time for any text
- Sassy (NEW) - The Anti-Newsletter Companion that helps newsletter authors write personal emails
- 🔮 Synchronicity Engine Powered Tools (JUST ADDED) - Pattern recognition tools coming soon
- Responsive Design: Mobile-first approach with category-specific styling and theming
- SEO Optimized: Dynamic metadata generation for all pages
- Article System: Simple, maintainable structure with consistent layouts
- Legal Pages: Privacy Policy and Terms of Service with proper navigation
- Email System: Professional email infrastructure with Resend
- Contact form with auto-reply functionality
- Newsletter subscription with welcome emails
- Unsubscribe functionality
- Category Theming:
- Blue (Concepts)
- Orange (Case Studies)
- Green (Projects)
- Purple (Random)
- Teal (Tools)
- Black (About/Legal)
Recent Updates
Email Service Migration: SendGrid → Resend (September 30, 2025) 🔄
- BREAKING CHANGE: Migrated from SendGrid to Resend for email services
- Environment Variable Change:
SENDGRID_API_KEY → RESEND_API_KEY
- Why the change: SendGrid free trial expired, Resend offers better developer experience
- What's improved:
- Enhanced error logging and debugging capabilities
- New test endpoint
/api/test-resend for email verification
- Better email deliverability with verified
manaboodle.com domain
- Simplified API integration and cleaner error handling
- All email functionality preserved:
- Contact form notifications and auto-replies ✅
- Newsletter subscription with welcome emails ✅
- Unsubscribe functionality ✅
- Deployment Note: Update
RESEND_API_KEY in production environment variables
External Tools Integration: Clusters Pattern Recognition (September 30, 2025) 🔗
- Added external tool integration pattern for Pro Marketplace expansion
- Clusters tool launched: Advanced pattern recognition tool at
/go/clusters
- Professional loading transitions with branded experience
- URL masking: Clean
manaboodle.com/go/clusters redirects to external Vercel app
- Template established for future external tool integrations
- White/black theme consistency matching manaboodle aesthetic
Synchronicity Engine Tools Section Added (August 1, 2025) 🆕
- Updated Tools page with new Synchronicity Engine section
- Four new "coming soon" tools:
- Resume Cluster Analyzer - Find your career tribe
- Dating Profile Optimizer - See what type you attract
- Synchronicity Pattern Tracker - Track meaningful coincidences
- Content Theme Finder - Discover your writing patterns
- Enhanced UI/UX:
- Gradient background for Synchronicity Engine section
- Coming soon animations and overlays
- "NEW" badges and pulse animations
- Subscribe CTA linking to /subscribe page
- Professional tools section with original tool lineup restored
- Strategic positioning as free tools to build audience before pro tier launch
- Accurate messaging: Clarified that existing tools (Sassy, Read Time) are separate from AI-powered Synchronicity Engine
Tools Article & Featured Content Update (August 1, 2025)
- Created "Building Tools That Actually Matter" article
- New article showcasing the Tools category and Sassy
- Personal story about the evolution of Manaboodle
- Located at
/projects/tools
- Set as featured article on home page
- Updated content management:
- Added tools article to
lib/content.ts
- Updated home page to display tools as featured
- Added tools to projects list page
- Created custom hero image design for the article
- Image handling improvements:
- Created
/images/sassy.jpg for card displays
- Article page uses custom styled card with GIF
- Home and projects pages use standard image format
- Fixed display issues:
- Resolved GIF squishing in project cards
- Maintained proper aspect ratios across all views
- Added consistent styling for all article cards
To-Do / Next Steps
🎯 TOMORROW'S PRIORITIES (August 2, 2025)
Phase 1: Core Synchronicity Engine Backend (Next 3-4 days)
-
Create Universal Clustering Backend
- Set up
/app/api/synchronicity/ routes
- Implement clustering algorithms (K-means, DBSCAN, semantic)
- Add data processing pipeline for different content types
- Create database schema for storing clusters and user data
-
Build JTBD Interview Analyzer (MVP)
- Create
/app/tools/jtbd-research-suite/ directory
- Simple interview upload/paste interface
- Real-time clustering of customer needs
- Basic PDF export functionality
- This becomes the first working Synchronicity Engine tool
-
Technical Setup
- Install required dependencies:
scikit-learn, sentence-transformers, numpy
- Set up Supabase tables for tool usage tracking
- Create reusable clustering components for other tools
Phase 2: Fun Tools Implementation (Week 2)
4. Resume Cluster Analyzer
- Upload/paste resume functionality
- Career pattern recognition
- "Your tribe" results page with sharing
- Move from "coming soon" to "available"
- Dating Profile Optimizer
- Profile text analysis
- Compatibility cluster identification
- Shareable results ("I attract Adventure Seekers!")
- Move from "coming soon" to "available"
Phase 3: Additional Tools (Week 3-4)
6. Synchronicity Pattern Tracker
- Life event logging interface
- Pattern detection algorithms
- Meaningful coincidence scoring
- Timeline visualization
- Content Theme Finder
- Writing analysis
- Theme cluster identification
- Voice pattern recognition
- Writer insights dashboard
🔄 ONGOING TASKS
- Email Preferences Page: UI complete at
/preferences, functionality pending
- Article Notification System: Notify subscribers of new content
- Domain Verification: Complete Resend domain setup for optimal deliverability
📋 TECHNICAL DEBT
- Optimize image loading across all pages
- Add error handling for all tool interfaces
- Implement proper TypeScript types for all new components
- Add comprehensive testing for clustering algorithms
� Article Publishing System
Content Management Overview
Manaboodle uses a simple, maintainable article system with centralized content management and automated deployment.
Article Publishing Process
1. Content Structure
- All articles are managed in
/src/lib/content.ts
- Featured article appears on home page and gets priority in search results
- Categories:
concept, project, casestudy, random
- Each article has: id, title, excerpt, category, publishedAt, readTime, featured, slug, author, content
2. Adding New Articles
// Example article entry in content.ts
{
id: 'article-slug',
title: 'Article Title',
excerpt: 'Brief description for cards and previews',
category: 'concept', // concept | project | casestudy | random
publishedAt: '2025-09-26',
readTime: 2,
featured: true, // Only one article should be featured at a time
slug: 'article-slug',
author: 'Author Name',
content: `Full article content for search functionality...`
}
3. Creating Article Pages
- Create directory:
/src/app/[category]/[article-slug]/
- Create page:
/src/app/[category]/[article-slug]/page.tsx
- Use existing templates (e.g.,
/concepts/ai-nurturing/page.tsx) as reference
- Include proper metadata, navigation, images, and content structure
4. Image Management
- Add images to
/public/images/[image-name].jpg
- Update category page mappings (e.g.,
/concepts/page.tsx) with image paths
- Images appear in: home featured card, category list page, article header
5. URL Mapping & Navigation
- Update category page URL mappings for custom routes
- Add article ID to home page
allowedArticleIds array if it should appear on homepage
- Example:
'synthetic-intelligence-truth': '/concepts/synthetic-intelligence-truth'
6. Deployment
- All changes auto-deploy via Vercel when pushed to main branch
- No build process needed - Next.js handles everything automatically
- Search functionality updates automatically with new content
⚠️ IMPORTANT: Avoiding Duplicates
- Use consistent naming: Choose ONE slug format and stick to it
- Check existing folders: Before creating new article, verify no similar folders exist
- Clean up immediately: If duplicates are created, delete unused folders immediately
- Follow the pattern: Use descriptive, URL-friendly slugs (kebab-case)
- Single source of truth: The article ID in
content.ts must match the folder name exactly
Recent Article Updates
Repository Cleanup (September 26, 2025)
- Removed duplicate article folder: Deleted
/concepts/synthetic-intelligence-truth/
- Consolidated structure: Using
/concepts/k-pop-demon-hunters-synthetic-truth/ as the single source
- Updated README: Added warnings and best practices to prevent future duplicates
- Article formatting: Fixed paragraph spacing and image caption placement
Latest: "Helping Kids Nurture Synthetic Intelligence to Form 'Truth'" (September 26, 2025)
- New Featured Article: Replaces childcare startup article as home page featured
- Category: Concept - exploring AI, children, education, and synthetic truth
- Image: Uses
/images/hi.jpg across all three display contexts
- Content Flow: Home featured → Concepts list → Full article page
- Previous Featured: Moved childcare startup article to regular projects list
- Formatting: Added proper paragraph breaks and correct image caption text
Previous: Childcare Startup Article (September 7, 2025)
- Status: Moved from featured to regular project article
- Author: Jenna Winocur - first guest author on the platform
- Impact: Established guest author functionality and content diversity
Category-Specific Pages
Concepts (/concepts/)
- Focuses on ideas, theories, and conceptual explorations
- Current articles: AI Nurturing, Synthetic Intelligence & Truth
- Template: Use
/concepts/ai-nurturing/page.tsx for new concept articles
Projects (/projects/)
- Showcases actual work, tools, and implementations
- Includes: Tools, Childcare Startup Journey, Nanny project, KaraokeGoGo
- Template: Use existing project article structure
Case Studies (/casestudies/)
- In-depth analysis of real-world implementations
- Currently: Mangrove case study
- Template: Use
/casestudies/mangrove/page.tsx
Random (/random/)
- Personal thoughts, quick ideas, experimental content
- Flexible format for various content types
�🛠️ Synchronicity Engine Architecture
Core Technology Stack
- Pattern Recognition: Scikit-learn, Sentence-BERT embeddings
- Backend: Next.js API routes with TypeScript
- Database: Supabase for user data and cluster storage
- Frontend: React components with CSS Modules
- Deployment: Vercel with automatic scaling
Tool Structure
app/tools/
├── page.tsx # Main tools listing (UPDATED)
├── synchronicity-engine/ # Coming soon landing page
├── jtbd-research-suite/ # First working tool (NEXT)
├── resume-analyzer/ # Career clustering
├── dating-optimizer/ # Profile analysis
├── synchronicity-tracker/ # Life pattern detection
└── content-theme-finder/ # Writing analysis
API Architecture
app/api/
├── synchronicity/
│ ├── cluster/ # Main clustering endpoint
│ ├── jtbd/ # JTBD-specific processing
│ ├── resume/ # Resume analysis
│ ├── dating/ # Profile optimization
│ └── patterns/ # Synchronicity detection
🎯 Strategic Roadmap
Phase 1: Engine + JTBD (September 2025)
- ✅ Tools page updated with Synchronicity Engine
- 🔄 Core clustering backend built
- 🔄 JTBD Interview Analyzer launched
- 🔄 First customer validation and testimonials
Phase 2: Fun Tools for Growth (Oct-Dec 2025)
- 🔄 4 fun pattern recognition tools launched
- 🔄 Viral sharing features implemented
- 🔄 Newsletter growth through tool discovery
- Target: 1000+ tool users, 500+ newsletter subscribers
Phase 3: Member Registration (Jan-Mar 2026)
- Member accounts for tool history
- Email sequences for engagement
- Community features planning
- Target: 500+ registered members
Phase 4: Pro Tier Launch (Apr+ 2026)
- Advanced business tools
- API access for developers
- Enterprise features
- Target: $5K+ MRR from pro subscriptions
📁 Project Structure
manaboodle/
├── app/
│ ├── tools/
│ │ ├── page.tsx # UPDATED: Synchronicity Engine section
│ │ ├── tools.module.css # UPDATED: New animations and styling
│ │ ├── read-time-calculator/
│ │ ├── sassy/
│ │ └── [NEW TOOLS COMING]/
│ ├── api/
│ │ ├── synchronicity/ # NEW: Clustering API routes
│ │ ├── contact/
│ │ ├── subscribe/
│ │ └── preferences/
│ └── [existing structure]
├── lib/
│ ├── clustering.ts # NEW: Core clustering logic
│ ├── content.ts # Content management
│ └── utils.ts
└── [existing structure]
🚀 Getting Started
Prerequisites
- Node.js 18.x or higher
- npm or yarn
- Supabase account
- Resend account (for email features)
New Dependencies for Synchronicity Engine
# Install ML/clustering dependencies
npm install scikit-learn sentence-transformers numpy pandas
# Python bridge for Node.js (if needed)
npm install python-bridge
Installation
- Clone the repository:
git clone https://github.com/yourusername/manaboodle.git
cd manaboodle
- Install dependencies:
npm install
- Set up environment variables:
cp .env.example .env.local
Update .env.local with your credentials:
# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
# Resend (Email Service)
RESEND_API_KEY=your_resend_api_key
# App URL
NEXT_PUBLIC_APP_URL=http://localhost:3000
# NEW: Synchronicity Engine
OPENAI_API_KEY=your_openai_key # For embeddings if needed
CLUSTERING_SECRET=your_secret_key # For API security
- Run the development server:
npm run dev
Visit http://localhost:3000 to see your site.
🛠️ Synchronicity Engine Development Guide
Creating New Pattern Recognition Tools
- Create tool directory:
/app/tools/[tool-name]/
- Add clustering logic: Implement specific data processing
- Build UI components: Results visualization, input forms
- Update tools list: Add to
tools array in /app/tools/page.tsx
- Test and iterate: User feedback and algorithm tuning
Key Design Principles
- Shareable Results: Every tool should generate shareable insights
- Pattern Storytelling: Help users understand what patterns mean
- Progressive Enhancement: Start simple, add complexity based on usage
- Privacy First: Local processing where possible, transparent data use
📧 Email Configuration
The platform uses Resend for all email communications:
Migration from SendGrid (September 30, 2025)
- Previous: SendGrid with
SENDGRID_API_KEY
- Current: Resend with
RESEND_API_KEY
- Benefits: Better developer experience, enhanced error logging, improved deliverability
- Verification: Domain verified at
manaboodle.com
- Test Endpoint:
/api/test-resend for debugging email functionality
Sender Addresses
[email protected] - Contact form and direct communication- All emails sent from verified
manaboodle.com domain
Email Functionality
- Contact Form: Notification emails to admin + auto-reply to visitors
- Newsletter Subscription: Welcome emails with unsubscribe tokens
- Enhanced Error Handling: Comprehensive logging for debugging
- Fallback Support: Graceful degradation if email service is unavailable
NEW: Tool Notification System
- Welcome emails for new tool launches
- Pattern discovery updates via subscription
- Early access notifications for pro features
🔮 Future Roadmap
Near Term (Next 30 days)
- Core Synchronicity Engine backend
- JTBD Interview Analyzer launch
- Resume Cluster Analyzer beta
- User feedback collection system
Medium Term (3-6 months)
- All 4 fun tools launched and viral
- Member registration system
- Community features (comments, sharing)
- Mobile app planning
Long Term (6+ months)
- Pro tier with advanced business tools
- API marketplace for developers
- AI-powered life coaching features
- International expansion
🏛️ Algorithm & Patent Archive
Patent-worthy clustering algorithm development archived in: /ALGORITHM_PATENT_ARCHIVE/
The repository contains a novel Deterministic K-Means Clustering Algorithm with business intelligence integration. All patent documentation, algorithm source code, and development history are organized in the archive folder for easy access and patent filing.
Key Innovation: First clustering algorithm that produces identical, reproducible results for business analysis applications.
🤝 Contributing
Contributions are welcome! Current focus areas:
- Pattern recognition algorithm improvements
- UI/UX enhancements for tool interfaces
- Performance optimization for clustering operations
- Mobile responsiveness testing
📞 Contact
For inquiries, collaboration, or feedback about the Synchronicity Engine, please use the contact form on the website or email [email protected].
Built with ❤️ by Manabu | Powered by the Synchronicity Engine 🔮
