🚀 Meemo - AI-Powered Productivity App

A comprehensive productivity application that combines task management, note-taking, and AI-powered assistance to help users capture, organize, and act on their thoughts and commitments.

🌐 Live Demo • 📖 Documentation • 🐛 Report Bug • ✨ Request Feature

✨ Features

• 🎤 Quick Capture: Voice and text input with AI-powered summarization
• ✅ Task Management: Intelligent task creation and organization
• 🔔 Smart Reminders: Flexible notification system with nudge windows
• 🔗 External Integrations: Google Calendar, Slack, and Jira synchronization
• 📱 Offline Support: Full functionality with automatic sync when online
• 🏠 Home Screen Widget: Quick capture without opening the full app
• 🤖 AI Processing: Automatic entity extraction and content summarization
• 🎨 Modern UI: Material Design 3 with dark/light theme support

🏗️ Architecture

Tech Stack

• 🎯 Mobile: Flutter (Dart) with Riverpod state management
• ⚡ Backend: Go with Fiber web framework
• 🗄️ Database: PostgreSQL with Redis caching
• 🤖 AI Integration: Kiro (primary) with OpenAI fallback
• ☁️ Infrastructure: AWS ECS Fargate, RDS, ALB

🚀 Quick Start

Prerequisites

• Go 1.21+
• Flutter 3.16+
• PostgreSQL 15+
• Redis 7+
• Docker & Docker Compose

1️⃣ Clone & Setup

git clone https://github.com/yourusername/meemo.git
cd meemo

2️⃣ Start Backend

cd backend
cp .env.example .env
go mod download
go run main.go

Backend will be running at: http://localhost:8080

3️⃣ Start Mobile App

cd mobile
flutter pub get
flutter run -d web-server --web-port 3001

Mobile app will be running at: http://localhost:3001

4️⃣ Database Setup

# Using existing PostgreSQL instance
docker exec -it local_pgdb psql -U postgres -c "CREATE DATABASE meemo_dev;"
docker cp backend/migrations/000001_initial_schema.up.sql local_pgdb:/tmp/
docker exec -it local_pgdb psql -U postgres -d meemo_dev -f /tmp/000001_initial_schema.up.sql

📁 Project Structure

meemo/
├── 🔧 backend/                 # Go API server
│   ├── cmd/                   # Application entry points
│   ├── internal/              # Private application code
│   │   ├── auth/             # Authentication services
│   │   ├── config/           # Configuration management
│   │   ├── database/         # Database connection
│   │   ├── handlers/         # HTTP handlers
│   │   ├── models/           # Database models
│   │   ├── services/         # Business logic
│   │   └── integrations/     # External API clients
│   ├── migrations/           # Database migrations
│   ├── pkg/                  # Public packages
│   └── tests/                # Integration tests
├── 📱 mobile/                 # Flutter application
│   ├── lib/
│   │   ├── core/            # Core utilities and constants
│   │   ├── features/        # Feature-based modules
│   │   │   ├── auth/        # Authentication
│   │   │   ├── notes/       # Note management
│   │   │   ├── tasks/       # Task management
│   │   │   └── integrations/ # External integrations
│   │   ├── shared/          # Shared widgets and services
│   │   └── main.dart        # Application entry point
│   ├── test/                # Unit tests
│   ├── integration_test/    # Integration tests
│   └── android/ios/         # Platform-specific code
├── 📚 docs/                  # Documentation
├── 🔄 .github/              # CI/CD workflows
├── 🐳 docker-compose.yml     # Development services
└── 📋 Makefile              # Development commands

🛠️ Development Commands

Backend Commands

# Run development server
go run main.go

# Run tests with coverage
go test -v -race -coverprofile=coverage.out ./...

# Build for production
go build -o bin/meemo-api main.go

# Database migrations
docker exec -it local_pgdb psql -U postgres -d meemo_dev -f /tmp/migration.sql

Mobile Commands

# Run on web (development)
flutter run -d web-server --web-port 3001

# Run on device/simulator
flutter run

# Run tests
flutter test --coverage

# Build for release
flutter build apk --release
flutter build web --release

Development Workflow

# Start all services
make dev

# Run backend only
make backend-dev

# Run mobile only  
make mobile-dev

# Run tests
make test

# Clean build artifacts
make clean

🧪 Testing

API Testing

# Health check
curl http://localhost:8080/api/v1/health

# Test endpoints
curl http://localhost:8080/api/v1/notes
curl http://localhost:8080/api/v1/tasks

Mobile Testing

• Unit Tests: flutter test
• Widget Tests: Test individual components
• Integration Tests: Test complete user flows
• Web Testing: http://localhost:3001

📊 Database Schema

The app uses PostgreSQL with the following main tables:

• users: User accounts and authentication
• sessions: Session management and refresh tokens
• notes: Raw content with AI processing results
• tasks: Task management with external source tracking
• reminders: Flexible scheduling with RRULE support
• integrations: External service connections

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with Flutter and Go
• AI integration powered by Kiro
• Icons from Material Design Icons

📞 Support

• 📧 Email: [email protected]
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions

---

Made with ❤️ by the Meemo Team

⭐ Star this repo • 🍴 Fork this repo • 📢 Share on Twitter