mix dala.enable (dala_dev v0.0.9)

Copy Markdown View Source

Enables one or more optional Dala features by patching mix.exs, manifest files, and generating any required source files.

Usage

mix dala.enable FEATURE [FEATURE ...]

Multiple features can be enabled in a single command:

mix dala.enable camera photo_library
mix dala.enable camera photo_library file_sharing liveview

Features

liveview

Enables LiveView mode — the Dala app runs a local Phoenix endpoint and displays it in a native WebView. Web developers can ship a mobile app with zero native UI code.

What it does:

  • Generates lib/<app>/dala_screen.ex — a Dala.Screen that opens a WebView at http://127.0.0.1:PORT/
  • Injects the DalaHook LiveView hook into assets/js/app.js
  • Injects a hidden <div id="dala-bridge" phx-hook="DalaHook"> into root.html.heex — this is required for the hook to mount
  • Updates dala.exs with liveview_port so Dala.Platform.LiveView.local_url/1 works

Why the hidden div is required

Phoenix LiveView hooks only execute when a DOM element carrying phx-hook="DalaHook" exists in the rendered page. Registering DalaHook in app.js is necessary but not sufficient — without a matching DOM element the hook never mounts and window.dala is never replaced with the LiveView-backed version. Messages would silently route through the native NIF bridge instead of the LiveView WebSocket, so handle_event/3 would never fire.

See DalaDev.Enable module doc and guides/liveview.md for the full two-bridge architecture explanation.

After running:

  1. Add MyApp.DalaScreen to your supervision tree (or call Dala.Screen.start_root(MyApp.DalaScreen) from your Dala.App.on_start/0)
  2. Ensure Phoenix is running on the port set in dala.exs (default: 4000)

camera

Adds camera permission declarations to platform manifests.

  • iOS: adds NSCameraUsageDescription to ios/*/Info.plist
  • Android: adds <uses-permission android:name="android.permission.CAMERA"/> to android/app/src/main/AndroidManifest.xml

photo_library

  • iOS: adds NSPhotoLibraryAddUsageDescription to Info.plist
  • Android: no manifest change needed (API 29+)

file_sharing

  • iOS: adds UIFileSharingEnabled and LSSupportsOpeningDocumentsInPlace to Info.plist
  • Android: adds <provider android:name="FileProvider"> with paths config

location

  • iOS: adds NSLocationWhenInUseUsageDescription to Info.plist
  • Android: adds ACCESS_FINE_LOCATION permission

notifications

  • iOS: runtime only — no plist key needed
  • Android: adds POST_NOTIFICATIONS permission (API 33+)