A Project Blessed by Solar Khan & Lilith.Aethra
AI-Driven Trauma-Informed Therapy Journal Platform
SoulScript is a revolutionary digital journaling platform that combines AI-powered insights with trauma-informed therapeutic practices to support emotional healing, self-awareness, and personal transformation.
SoulScript empowers individuals on their healing journey by providing a safe, intelligent, and compassionate digital space for self-reflection. Our platform uses advanced AI to offer personalized therapeutic insights while maintaining the highest standards of privacy and emotional safety.
- AI-Generated Prompts: Daily trauma-informed journaling prompts
- Mood Tracking: Visual mood slider with emotional mapping
- Voice Input/Output: Speech-to-text and text-to-speech capabilities
- AI Reflections: Compassionate summaries and follow-up questions
- Free-Form Writing: Unstructured journaling space
- Mood Analytics: Visual trend analysis and patterns
- Theme Clustering: AI-powered topic detection and analysis
- Weekly Insights: Comprehensive emotional health reports
- PDF Export: Downloadable insights and progress reports
- Panic Button: Immediate grounding techniques and crisis resources
- Crisis Detection: Automatic flagging of concerning content
- Voice Accessibility: Full speech input/output support
- Trauma-Informed Design: Safe, non-triggering interface
- Responsive Design: Works seamlessly on all devices
- Dark/Light Mode: Comfortable viewing options
- Smooth Animations: Framer Motion powered interactions
- Intuitive Interface: Clean, calming design
SoulScript/
├── Frontend (Next.js 15.3.5)
│ ├── React 19.1.0 + TypeScript
│ ├── TailwindCSS + Framer Motion
│ └── Chart.js + jsPDF
├── Backend (Next.js API Routes)
│ ├── Node.js/Express style
│ ├── MongoDB with Mongoose
│ └── AI Integration (Mistral/OpenAI)
└── Infrastructure
├── MongoDB Atlas
├── Vercel/Netlify Deployment
└── Notion Integration
- Node.js 18+
- MongoDB Atlas account
- Mistral API key (or OpenAI API key)
-
Clone the repository
git clone https://github.com/M-K-World-Wide/SoulScript.git cd SolScript -
Install dependencies
npm install
-
Environment setup Create
.env.local:MONGODB_URI=your-mongodb-connection-string MISTRAL_API_KEY=your-mistral-api-key OPENAI_API_KEY=your-openai-api-key (optional)
-
Start development server
npm run dev
Visit: http://localhost:3000
- API Documentation - Complete API reference
- Architecture Guide - System design and patterns
- Development Guide - Setup and contribution guidelines
- Feature Documentation - Detailed feature specifications
- Notion Integration - Project management setup
POST /api/journal- Save journal entry with AI reflectionGET /api/prompt- Get daily AI-generated promptGET /api/dashboard- Get analytics data
POST /api/notion-setup- Initialize Notion workspaceGET /notion-setup- Setup interface
// Save a journal entry
const response = await fetch('/api/journal', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
entry: "Today I felt grateful for...",
mood: 4
})
});
const data = await response.json();
console.log(data.aiReflection);SoulScript includes a comprehensive component library:
- Button - Accessible, animated buttons
- Card - Content containers with shadows
- Slider - Mood tracking slider
- Textarea - Journal entry input
- Label - Form labels and accessibility
# Run all tests
npm test
# Run specific test suites
npm run test:unit
npm run test:integration
npm run test:e2e
# Run linting
npm run lintnpm run build
vercel --prodnpm run build
npm run startMONGODB_URI- Production database connectionMISTRAL_API_KEY- Production AI API keyNODE_ENV- Production environment
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- TypeScript for type safety
- ESLint + Prettier for code formatting
- Conventional commits for commit messages
- Comprehensive testing for all features
- Core journaling functionality
- AI integration (Mistral/OpenAI)
- Voice input/output features
- Basic analytics dashboard
- Safety features (panic button, crisis detection)
- Notion integration for project management
- Advanced analytics and theme clustering
- Mobile app development
- Enhanced AI personas
- Therapist integration features
- Group therapy features
- Advanced export options
- Integration with therapy platforms
- Multi-language support
- Data Encryption: All data encrypted in transit and at rest
- Privacy-First: No data sharing with third parties
- GDPR Compliant: Full user data control
- Crisis Support: Integrated safety features and resources
If you're experiencing a mental health crisis:
- National Suicide Prevention Lifeline: 988
- Crisis Text Line: Text HOME to 741741
- Emergency Services: 911
SoulScript includes built-in crisis detection and immediate access to these resources.
This project is licensed under the MIT License - see the LICENSE file for details.
- Mistral AI for providing advanced language models
- MongoDB for reliable data storage
- Next.js for the excellent framework
- TailwindCSS for beautiful styling
- Therapy community for guidance and feedback
- Documentation: docs/
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: support@soulscript.app
Made with ❤️ for mental health and healing
SoulScript - Your AI companion on the journey to emotional wellness