🌙 Lunelle

Lunelle is a premium, high-fidelity period tracker designed with a focus on elegance, privacy, and wellness. It features a sophisticated design system, smooth animations, and a seamless onboarding experience to help users track their cycle, mood, and symptoms with ease.

---

✨ Features

• 🎨 Premium UI/UX: A cohesive design system featuring soft pink and lavender gradients.
• 🚀 Smooth Onboarding: Interactive multi-page onboarding flow to welcome users.
• 🔐 Secure Authentication: Immersive Login and Signup screens with validation and social auth integration (Google/Apple).
• 📱 Adaptive Design: Optimized for a fluid experience across different screen sizes.
• 🛠️ Modular Architecture: Clean, feature-based directory structure for high maintainability.
• ⚡ Performance Optimized: Enabled R8 minification and resource shrinking for a lean app footprint.

---

🎨 Design System

Lunelle uses a carefully curated visual identity to provide a calming and premium user experience:

• Typography:
  • DM Serif Display: For elegant, trustworthy headlines.
  • Poppins: For clean, highly readable body text.
• Color Palette: A blend of Blush Rose, Lavender, and soft cream whites.
• Components: Custom-built reusable widgets including animated gradient buttons and stylized input fields.

---

🏗️ Project Structure

lib/
├── core/
│   ├── constants/    # Centralized asset paths
│   ├── splash/       # Minimalist brand intro
│   ├── theme/        # Global design system & colors
│   └── widgets/      # Reusable UI components
└── features/
    ├── auth/         # Login, Signup, and Auth logic
    ├── home/         # Main application dashboard
    └── landing/      # Onboarding and entry flow

database/
└── schema.sql        # Supabase table definitions and queries

---

🚀 Getting Started

Prerequisites

• Flutter SDK (latest stable version)
• Android Studio / VS Code
• Git

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/lunelle.git

2. Navigate to the project directory:

   cd lunelle

3. Install dependencies:

   flutter pub get

4. Run the app:

   flutter run

---

📦 Build & Optimization

The project is pre-configured for production excellence:

• R8 Full Mode: Enabled for aggressive code minification.
• Resource Shrinking: Removes unused assets during the build process.
• Memory Optimized: Balanced JVM allocation for efficient development.

Build the release APK:

flutter build apk --release

---

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

---

📜 License

Distributed under the MIT License. See LICENSE for more information.

---

Made with ❤️ for wellness.