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 #

📸 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 #

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

📚 Documentation #

🔑 Key Dependencies #

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.