feature/supa_avatar

[0xharkirat]

What kind of change does this PR introduce?

• ✨ Feature: Add SupaAvatar widget for displaying & editing user profile avatars.
• 📝 Documentation: Include full usage and customization guide in README.
• 🔧 Refactor: Restructure example app folders for clarity & modularity.
• 🚦 Routing: Add go_router with route redirection based on Supabase auth state.
• 🐛 Bugfix
• ✅ Test updates

---

What is the current behavior?

• No reusable avatar upload component for Supabase users.
• Example app has a flat and less scalable structure.
• No route redirection based on user auth session.

---

What is the new behavior?

🖼️ SupaAvatar Widget

• Readonly & editable avatar display
• Upload, override, and delete from Supabase Storage
• Customizable metadata key (avatar_url by default)
• Cache-busting for real-time UI updates
• Bottom sheet for picking or removing avatar
• Configurable design via props

🗂️ Refactored Folder Structure of example app

Organized example app into:

lib/
└── src/
    ├── core/       # App config and shared constants
    │   └── app_router.dart
    └── views/      # Screens: SignIn, Home, etc.

🔐 Auth-Aware Routing

• Redirects to /sign_in_up if user is signed out
• Redirects to / if user is signed in

---

Additional context

Usage

SupaAvatar(
  radius: 48,
  isEditable: true,
  supabaseStoragePath: 'profile',
)

[0xharkirat]

Added: Editor Type (modal or dialog),
Shows username or email initials while the image is loading using my own package ui_avatar,

Much more to come.

[0xharkirat]

fix the ui of avatar editor to clean & simple.

dialog	modal

[0xharkirat]

Hey Team, any comments or feedback? I am planning to build more flutter ui components for supabase, like firebase has for storage, database & many more.