Rolling with Mandelbrot

Welcome to the Mandelbrot iOS app! This project is a modern, SwiftUI-based application designed to bring fun, insight, and a touch of magic to your daily life. Whether you’re looking to roll dice for a quick decision, explore tarot readings, chat with mystical AI assistants, or get inspired in the kitchen, this app has you covered.

Project Overview

Mandelbrot is a multi-featured lifestyle app that combines classic games, AI-powered chat, and practical tools into a beautiful, intuitive interface. It’s perfect for users who enjoy tarot, need a little luck, or want creative meal ideas, all in one place.

Features and User Flows

🎲 Rolling Dice

• Simulate rolling two dice with realistic animation and haptic feedback.
• Great for games, decision-making, or just for fun.

🃏 Tarot Card Game

• Choose from multiple tarot spreads (e.g., One-Card, Three-Card, Tree of Life, New Love).
• Tap to draw cards, see beautiful card art, and reveal insightful meanings.
• Includes a Lucky Draw Calendar: draw a tarot card for each day of the month and track your daily fortunes.

🔮  Tarot Chat

• Select your favorite tarot reader persona (e.g., Iris, Scarlett, Phoebe, Rosa), each with a unique style and avatar.
• Chat with an AI-powered mystical assistant for guidance on topics like love, career, and health.
• Switch readers and topics on the fly for a personalized experience.

🍽️ Cuisine Guide

• Browse curated cuisine categories and dishes (e.g., Italian, Chinese).
• Search for recipes, view ingredients, and follow step-by-step instructions.
• Pick ingredients to add to your cart, and use the "Lucky Draw" for random meal inspiration.
• AI-powered chat for cooking tips, substitutions, and creative ideas.

⚙️ Settings and Personalization

• Manage your profile, including login, registration, and guest mode.
• Access appearance and mode settings (future extensibility).
• Select and configure the AI model (OpenAI, Google Gemini, etc.) and securely manage your API key.
• View app info, terms, privacy policy, and contact options.

1.1 Project Overview . . . . . . . . . 2

1.2 Features & User Flows . . . . 3

1.3 Get Started . . . . . . . . . . . . . . 4

1.4 License . . . . . . . . . . . . . . . . . 5

1.5 Contributing . . . . . . . . . . . . . 6

Figure 1

Figure 2

Figure 3

Figure 4

🔑 Authentication & User Management

• Sign up or log in with email (Supabase backend), or continue as a guest with a fun, random username.
• Seamless session management and easy logout.

🤖 AI and LLM Integration

• Tarot and Cuisine Chat:
  • Powered by state-of-the-art LLMs (OpenAI, Google Gemini, etc.) via OpenRouter.
  • Users can select their preferred model and manage their API key securely in Settings.
• Extensible Prompts:
  • System prompts are tailored for mystical tarot readings and friendly culinary advice.

👤 User Management and Security

• Supabase Integration:
  • Handles user authentication, registration, and session management.
• Guest Mode:
  • Enjoy the app without registration—just pick a username and start exploring.
• Secure Storage:
  • API keys and sensitive data are stored securely using iOS Keychain.

Get Started

Explore the app, try out each feature, and enjoy a delightful, AI-enhanced experience. For a visual guide, check out the included screenshots for every page.

If you’re a developer, the codebase is organized for clarity and extensibility, making it easy to add new features or customize existing ones.

License

This project is licensed under the MIT License, a permissive, open-source license that allows you to use, modify, and distribute the code freely, as long as you include the original copyright and license notice.

For full details, see the LICENSE file included in this repository.

Contributing

We welcome contributions from the community! If you’d like to help improve this project, add new features, or fix bugs, here’s how you can get started:

1. Open an Issue:

If you find a bug or have a feature request, please open an issue describing the problem or idea.

2. Fork the Repository:

Create your own fork and make your changes in a feature branch.

3. Pull Requests:

Submit a pull request with a clear description of your changes. Please reference any related issues.

4. Code Style:

Follow Swift best practices and keep code clean, readable, and well-commented.

5. Communication:

Be respectful and constructive in all discussions. We value a friendly, inclusive community.