@codebards/ik-embeddable-form 1.0.44 → 1.0.46

package/README.md

@@ -303,25 +303,41 @@ npm run build:production # Builds with .env.production (minified)
 
 ```
 dist/
-├── embed.js        # Self-contained IIFE bundle (reference in <script>)
-└── embed.js.map    # Source map (only in staging/local builds)
+├── embed.js        # IIFE bundle (reference in <script>)
+├── embed.js.map    # Source map (only in staging/local builds)
+└── img/            # Runtime bitmaps — must ship alongside embed.js
+    ├── flags.png
+    ├── flags@2x.png
+    ├── company-logos-grid.png
+    └── india-flag.png
 ```
 
+`img/` is **not optional**. The widget resolves those files at runtime against the URL
+`embed.js` itself was served from, so they have to sit in an `img/` directory next to it —
+upload the whole `dist/` tree, not just `embed.js`. Deploying `embed.js` alone leaves the
+phone-input country flags and the promo panel's logo grid as broken images. They are
+requested lazily, so nothing 404s until a form actually renders the element that needs one.
+
 ### Deployment Checklist
 
 1. Run `npm run build:production`
-2. Upload `dist/embed.js` to your CDN with a versioned path:
+2. Upload `dist/embed.js` **and `dist/img/`** to your CDN under a versioned path:
    ```
    https://cdn.example.com/forms/v1.0.0/embed.js
+   https://cdn.example.com/forms/v1.0.0/img/…
    ```
 3. Set cache headers:
    - `embed.js` → `Cache-Control: public, max-age=31536000, immutable` (versioned path)
+   - `img/*` → `Cache-Control: public, max-age=31536000, immutable` (URLs are version-stamped
+     with a `?v=` query, so a release changes them)
    - Use a `latest` alias for convenience: `cdn.example.com/forms/latest/embed.js` with shorter TTL
 
 4. Reference on the host page:
    ```html
-   <script src="https://cdn.example.com/forms/v1.0.0/embed.js" async></script>
+   <script src="https://cdn.example.com/forms/v1.0.0/embed.js" defer></script>
    ```
+   `defer` (or `async`) matters: the bundle is large enough that a plain parser-blocking
+   `<script>` measurably delays first paint on mobile.
 
 ---