odoo_view_builder_flutter

A professional visual drag-and-drop editor for generating Odoo XML views — Form, Tree, and Kanban — built with Flutter and running on every platform.

---

✨ Features

Category	What you get
🎨 Visual Editor	Drag fields from a typed palette onto a live canvas; organise into groups and notebook pages
🌳 All View Types	Form · Tree (List) · Kanban — each with a dedicated editor
👁 Live XML Preview	Syntax-highlighted XML updates in real time as you build
✅ Validation	Field name rules, XML structure checks, Odoo 14–18 compatibility warnings
📤 Multi-Platform Export	Download file · Copy to clipboard · Native share sheet · Web blob download
📥 Import XML	Parse existing Odoo XML back into the visual editor
📚 Template Library	10 built-in templates for common models (partner, sale order, product …)
🔗 Odoo API Connect	Fetch live field definitions directly from a running Odoo instance
↩ Undo / Redo	50-step history across all edit actions
💾 Local Persistence	Views auto-saved to SQLite; settings in SharedPreferences
📊 Analytics	Firebase-ready analytics service (works without Firebase too)
🐛 Crash Reporting	Crashlytics-ready crash reporter with local log fallback

---

📸 Screenshots

┌──────────────────────────────────────────────────────────────────┐
│  ⬅ Back   Custom Partner Form (res.partner)        </> Export    │
├──────────────┬────────────────────────────────┬──────────────────┤
│ FIELD TYPES  │         CANVAS                 │   PROPERTIES     │
│              │                                │                  │
│ [Aa] Text    │  ┌─ group: General Info ──────┐│  Field: name     │
│ [#] Integer  │  │  [name*]      [phone]       ││  Label: Name     │
│ [.] Float    │  │  [email]      [website]     ││  Widget: char    │
│ [✓] Boolean  │  └────────────────────────────┘│  Required: ✓     │
│ [📅] Date    │                                │  Readonly: ☐     │
│ [🕒] DateTime│  ┌─ group: Address ───────────┐│  Colspan: 1      │
│ [¶] Text     │  │  [street]                   ││                  │
│ [<>] HTML    │  │  [city]       [zip]         ││  ─────────────── │
│ [📎] File    │  └────────────────────────────┘│  + Add widget    │
│ [▾] Select   │                                │                  │
│ [→] Many2One │        ⊕ Drop field here       │                  │
│ [⋮] Many2M   │                                │                  │
│ [≡] One2Many │                                │                  │
└──────────────┴────────────────────────────────┴──────────────────┘

---

🚀 Quick Start

Prerequisites

• Flutter SDK ≥ 3.10.0
• Dart SDK ≥ 3.0.0

Install

git clone https://github.com/Brah-Timo/odoo_view_builder_flutter.git
cd odoo_view_builder_flutter
flutter pub get

Run

# Android
flutter run -d android

# iOS
flutter run -d ios

# Web
flutter run -d chrome

# Desktop
flutter run -d macos      # or windows / linux

For detailed platform-specific setup (entitlements, permissions, Firebase) see doc/setup.md.

---

📦 Output Format

Every exported view is a standard Odoo module XML file that you can drop directly into your module/views/ folder:

<?xml version="1.0" encoding="utf-8"?>
<!-- Generated by Odoo View Builder -->
<odoo>
    <data>
        <record id="view_partner_form_custom" model="ir.ui.view">
            <field name="name">res.partner.form.custom</field>
            <field name="model">res.partner</field>
            <field name="arch" type="xml">
                <form>
                    <group string="General Info">
                        <field name="name" required="1"/>
                        <field name="email" widget="email"/>
                        <field name="phone" widget="phone"/>
                    </group>
                    <group string="Address">
                        <field name="street"/>
                        <field name="city"/>
                        <field name="zip"/>
                    </group>
                </form>
            </field>
        </record>
    </data>
</odoo>

---

🏗 Architecture

The app follows Clean Architecture with three layers:

Presentation  →  Domain  →  Data
(Riverpod)       (UseCases)   (sqflite / SharedPrefs / OdooAPI)

State management uses Riverpod 2 (StateNotifierProvider) throughout. XML generation is handled by the xml package's XmlBuilder API — never string concatenation.

→ Full architecture details: doc/architecture.md

---

🧩 Supported Odoo Versions

Odoo	Form	Tree	Kanban	Notes
14.0	✅	✅	✅	<sheet> recommended
15.0	✅	✅	✅
16.0	✅	✅	✅
17.0	✅	✅	✅	attrs/states removed
18.0	✅	✅	✅	<list> preferred

The compatibility validator flags issues when you switch the target version in Settings → Odoo Target Version.

---

📚 Documentation

Document	Description
doc/architecture.md	Layer design, data flow, key decisions
doc/setup.md	Dev environment & platform-specific setup
doc/usage_guide.md	End-user walkthrough of all features
doc/api_reference.md	Complete public API reference
doc/contributing.md	How to contribute, coding standards, PR process
doc/changelog_detail.md	Extended technical changelogs
doc/roadmap.md	Planned features and version targets
CHANGELOG.md	Concise version history

---

🔑 Key Dependencies

Package	Purpose
flutter_riverpod ^2.4.9	State management
xml ^6.4.2	XML generation and parsing
sqflite ^2.3.2	Local SQLite database
shared_preferences ^2.2.2	User preferences
path_provider ^2.1.2	Platform file paths
dio ^5.4.1 · http ^1.2.0	Odoo JSON-RPC API
share_plus ^7.2.2	Native share sheet
universal_html ^2.2.4	Web blob download
flutter_highlight ^0.7.0	XML syntax highlighting
uuid ^4.3.3	Unique ID generation
intl ^0.19.0	Formatting
logging ^1.2.0	Structured logging

Full dependency list: pubspec.yaml

---

🤝 Contributing

Contributions are welcome! Please read doc/contributing.md before opening a PR.

# Fork & clone
git clone https://github.com/Brah-Timo/odoo_view_builder_flutter.git

# Create a feature branch
git checkout -b feature/your-feature develop

# Implement, test, lint
flutter test && flutter analyze

# Open a PR targeting `develop`

---

🗺 Roadmap

See doc/roadmap.md for the full roadmap.

Highlights planned for v1.1.0:

• Search view type editor
• <notebook>/<page> visual layout in the form canvas
• Inline domain/filter builder
• Compatibility validator in the export flow

---

📄 License

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

---

🙏 Acknowledgements

• Odoo — for the open-source ERP platform and XML view specification.
• Flutter & the Dart team — for the cross-platform framework.
• Riverpod by Remi Rousselet — for the excellent state management solution.
• All contributors and testers who helped shape the editor.

---