docs: enhance navigation UX with tabs, tracking, indexes, social links, and clearer hierarchy

Author: devmsh

.gitignore

@@ -9,3 +9,4 @@
 .obsidian/plugins/obsidian-plugin-toc/data.json
 .obsidian/plugins/obsidian-plugin-toc/main.js
 .obsidian/plugins/obsidian-plugin-toc/manifest.json
+bond-docs/site/

docs/overview/index.md

@@ -1,214 +1,34 @@
 # What Is Bond
 
-## Introduction
+Welcome to Flutter Bond - a comprehensive toolkit for building production-ready Flutter applications with speed and confidence.
 
-Bond is a comprehensive Flutter development toolkit designed to accelerate the creation of production-ready mobile applications. At its core, Bond provides a cohesive set of packages, tools, and conventions that eliminate the repetitive setup work typically required when starting a new Flutter project.
+## What You'll Learn
 
-Think of Bond as the "Laravel for Flutter" - it provides opinionated yet flexible solutions for common mobile app requirements like networking, caching, form validation, push notifications, analytics, and authentication. Rather than piecing together disparate packages and figuring out how to make them work together, Bond gives you a unified ecosystem where everything is designed to work seamlessly.
+This section introduces Bond's core philosophy and helps you understand why it exists and how it can transform your Flutter development experience.
 
-## The Problem Bond Solves
+### What Is Bond
 
-When building Flutter applications, developers often face the same challenges repeatedly:
+Discover what makes Bond different from other Flutter frameworks and how it solves common development challenges through unified architecture and proven patterns.
 
-- **Boilerplate Setup**: Every new project requires the same tedious setup for networking, state management, dependency injection, and build configurations
-- **Package Integration**: Figuring out how to make different packages work together harmoniously
-- **Architecture Decisions**: Determining how to structure code, organize features, and manage dependencies
-- **Production Readiness**: Implementing flavors, CI/CD, analytics, crash reporting, and other production concerns
-- **Team Consistency**: Ensuring all team members follow the same patterns and conventions
+### [Philosophy](./philosophy/)
 
-Bond addresses these challenges by providing:
+Understand the design principles behind Bond, including convention over configuration, explicit dependencies, type safety, and developer experience first.
 
-1. **A Starter Template**: A production-ready Flutter app with all the essential setup already done
-2. **Core Packages**: A suite of packages that work together seamlessly
-3. **CLI Tools**: Commands to generate new projects, features, and boilerplate code
-4. **Clear Conventions**: Opinionated but flexible patterns for organizing code and managing dependencies
+### [Upgrades](./upgrades/)
 
-## What's in the Box
+Learn about Bond's versioning strategy, migration tools, and how to keep your applications up-to-date with the latest Bond features.
 
-Bond consists of four main components:
+## Quick Navigation
 
-### 1. Flutter Bond (Starter App)
+- **New to Bond?** Start with [What Is Bond](./what-is-bond/) to understand the framework
+- **Ready to build?** Jump to [Getting Started](/getting-started/) to create your first project
+- **Want to understand the architecture?** Read about [Philosophy](./philosophy/) and design decisions
 
-The `flutter-bond` repository provides a complete starter application that includes:
+## Key Concepts
 
-- **Multi-flavor setup** (production, staging) with separate Firebase configurations
-- **Environment management** using `--dart-define-from-file`
-- **Service Provider architecture** for dependency injection and feature organization
-- **Pre-configured packages** for networking, caching, forms, notifications, and analytics
-- **Build automation** with scripts for Firebase setup and app configuration
-- **Production-ready structure** with proper asset management, localization, and theming
+- **Service Providers**: Organize dependencies and feature boundaries
+- **Typed Everything**: Compile-time safety for networking, forms, and data
+- **Convention over Configuration**: Sensible defaults that scale
+- **Developer Experience**: Tools and patterns that make Flutter development enjoyable
 
-### 2. Bond Core (Package Ecosystem)
-
-The `bond-core` monorepo contains specialized packages for common mobile app needs:
-
-- **Core**: Base classes for Service Providers and response decoding
-- **Network (BondFire)**: Typed HTTP client built on Dio with caching and error handling
-- **Cache**: Flexible caching system with multiple drivers and object serialization
-- **Form**: Comprehensive form state management with validation and Riverpod integration
-- **Notifications (Beacon)**: Unified push and local notification handling with routing
-- **App Analytics**: Event tracking with provider adapters for Firebase, AppsFlyer, etc.
-- **Socialite**: Social authentication utilities and helpers
-
-### 3. Bond CLI (Development Tools)
-
-The `bond-cli` package provides command-line tools for:
-
-- **Project Creation**: Generate new Bond projects with interactive setup
-- **Feature Generation**: Scaffold new features with proper Service Provider structure
-- **Configuration Updates**: Change app names, bundle IDs, and package names
-- **Authentication Setup**: Add social login providers like Google, Apple, Facebook
-
-### 4. Bond Docs (This Documentation)
-
-Comprehensive documentation covering:
-
-- **Getting Started**: Step-by-step tutorials for new projects
-- **Core Concepts**: Deep dives into Service Providers, architecture, and patterns
-- **Package Guides**: Detailed usage instructions for each Bond package
-- **Recipes**: Common patterns and solutions for typical mobile app features
-- **Advanced Topics**: Performance optimization, testing strategies, and customization
-
-## Real-World Example
-
-Let's see how Bond simplifies a common scenario - adding user authentication to your app:
-
-### Without Bond (Traditional Approach)
-
-```dart
-// 1. Choose and configure packages
-dependencies:
-  dio: ^5.0.0
-  shared_preferences: ^2.0.0
-  flutter_secure_storage: ^9.0.0
-  riverpod: ^2.0.0
-  # ... many more
-
-// 2. Set up networking
-class ApiClient {
-  late Dio _dio;
-  
-  ApiClient() {
-    _dio = Dio(BaseOptions(
-      baseUrl: 'https://api.example.com',
-      // ... lots of configuration
-    ));
-    
-    // Add interceptors for auth, logging, etc.
-  }
-}
-
-// 3. Create models and serialization
-@JsonSerializable()
-class User {
-  // ... model definition
-}
-
-// 4. Build repository
-class AuthRepository {
-  // ... implementation
-}
-
-// 5. Set up state management
-// 6. Handle errors and loading states
-// 7. Configure dependency injection
-// ... hundreds of lines of boilerplate
-```
-
-### With Bond
-
-```dart
-// 1. Create project
-$ bond create project my_app
-
-// 2. Add authentication feature
-$ bond add auth
-
-// 3. Use the generated provider
-class AuthServiceProvider extends ServiceProvider with ResponseDecoding {
-  @override
-  Future<void> register(GetIt it) async {
-    it.registerLazySingleton<AuthRepository>(() => AuthRepository(it()));
-  }
-
-  @override
-  Map<Type, JsonFactory> get factories => {
-    User: (json) => User.fromJson(json),
-  };
-}
-
-// 4. Use in your UI
-final authRepo = GetIt.instance<AuthRepository>();
-await authRepo.login(email, password);
-```
-
-The Bond approach eliminates hundreds of lines of boilerplate and provides a tested, production-ready foundation.
-
-## Key Benefits
-
-### 1. Faster Development
-
-Bond eliminates the "blank page" problem. Instead of spending days setting up basic infrastructure, you can focus on building your app's unique features from day one.
-
-### 2. Consistent Architecture
-
-The Service Provider pattern and clear conventions ensure that all team members structure code the same way, making collaboration easier and code reviews more focused.
-
-### 3. Production Ready
-
-Bond includes all the production concerns you'll eventually need: multiple environments, analytics, crash reporting, push notifications, and proper build configurations.
-
-### 4. Testable by Design
-
-The dependency injection system and clear separation of concerns make it easy to write unit tests, integration tests, and widget tests.
-
-### 5. Scalable Structure
-
-The feature-based organization and modular architecture scale from small prototypes to large enterprise applications.
-
-## Who Should Use Bond
-
-Bond is ideal for:
-
-- **Startup Teams** who need to move fast and validate ideas quickly
-- **Enterprise Teams** who want consistent architecture across multiple apps
-- **Solo Developers** who don't want to reinvent the wheel for each project
-- **Teams New to Flutter** who want to learn best practices from the start
-- **Experienced Developers** who want to focus on business logic rather than infrastructure
-
-## Getting Started
-
-Ready to try Bond? Here's what to do next:
-
-1. **Install the CLI**: `dart pub global activate bond_cli`
-2. **Create a Project**: `bond create project`
-3. **Follow the Tutorial**: Continue with [Getting Started](/docs/getting-started)
-4. **Join the Community**: Connect with other Bond developers
-
-## Philosophy and Design Principles
-
-Bond is built on several key principles:
-
-### Convention over Configuration
-
-While Bond is flexible, it provides sensible defaults and conventions that work for most applications. This reduces decision fatigue and helps teams move faster.
-
-### Explicit Dependencies
-
-Using the Service Provider pattern with GetIt makes all dependencies explicit and testable. No hidden global state or magic.
-
-### Gradual Adoption
-
-You can adopt Bond incrementally. Start with just the networking package, or use the full starter template - it's up to you.
-
-### Developer Experience First
-
-Every decision in Bond prioritizes developer experience. From clear error messages to comprehensive documentation, Bond aims to make Flutter development enjoyable.
-
-## Next Steps
-
-Now that you understand what Bond is and why it exists, you're ready to:
-
-- [Learn the Philosophy](/docs/overview/philosophy) - Understand the design principles behind Bond
-- [Start Building](/docs/getting-started) - Create your first Bond application
-- [Explore the Packages](/docs/guides) - Deep dive into Bond's capabilities
+Ready to dive in? Continue with [What Is Bond](./what-is-bond/) or jump straight to [Getting Started](/getting-started/).

docs/overview/what-is-bond.md

@@ -0,0 +1,34 @@
+# Overview
+
+Welcome to Flutter Bond - a comprehensive toolkit for building production-ready Flutter applications with speed and confidence.
+
+## What You'll Learn
+
+This section introduces Bond's core philosophy and helps you understand why it exists and how it can transform your Flutter development experience.
+
+### What Is Bond
+
+Discover what makes Bond different from other Flutter frameworks and how it solves common development challenges through unified architecture and proven patterns.
+
+### [Philosophy](./philosophy/)
+
+Understand the design principles behind Bond, including convention over configuration, explicit dependencies, type safety, and developer experience first.
+
+### [Upgrades](./upgrades/)
+
+Learn about Bond's versioning strategy, migration tools, and how to keep your applications up-to-date with the latest Bond features.
+
+## Quick Navigation
+
+- **New to Bond?** Start with [What Is Bond](./what-is-bond/) to understand the framework
+- **Ready to build?** Jump to [Getting Started](/getting-started/) to create your first project
+- **Want to understand the architecture?** Read about [Philosophy](./philosophy/) and design decisions
+
+## Key Concepts
+
+- **Service Providers**: Organize dependencies and feature boundaries
+- **Typed Everything**: Compile-time safety for networking, forms, and data
+- **Convention over Configuration**: Sensible defaults that scale
+- **Developer Experience**: Tools and patterns that make Flutter development enjoyable
+
+Ready to dive in? Continue with [What Is Bond](./what-is-bond/) or jump straight to [Getting Started](/getting-started/).