Feat/inline delivery mode (#22)

* feat(publish): support inline Webflow delivery

* chore: release v1.3.0

Author: YNDmitry

README.md

@@ -72,6 +72,7 @@ Example:
   "repositoryName": "your-repo",
   "packageManager": "bun",
   "assetBranch": "wfkit-dist",
+  "deliveryMode": "cdn",
   "buildDir": "dist/assets",
   "devHost": "localhost",
   "devPort": 5173,
@@ -204,6 +205,22 @@ This flow:
 3. updates the Webflow custom code
 4. republishes the site
 
+By default, production publish uses `deliveryMode: "cdn"` and points Webflow at the artifact branch through jsDelivr.
+
+If you want to skip jsDelivr and write the built module code back into Webflow as managed inline scripts, run:
+
+```bash
+wfkit publish --env prod --delivery inline
+```
+
+Or set this once in `wfkit.json`:
+
+```json
+{
+  "deliveryMode": "inline"
+}
+```
+
 If you want to preview the publish plan without changing GitHub or Webflow, run:
 
 ```bash
@@ -246,8 +263,8 @@ That extended flow:
 
 1. writes the migrated local files
 2. builds the project
-3. pushes the artifact branch
-4. updates Webflow to the new jsDelivr URLs
+3. if `deliveryMode` is `cdn`, pushes the artifact branch
+4. updates Webflow using either jsDelivr URLs or managed inline scripts
 
 ## Release the CLI
 
@@ -372,6 +389,7 @@ Options:
 - `--dev-port` Local dev server port for legacy `dev` mode
 - `--dev-host` Local dev server host for legacy `dev` mode
 - `--custom-commit` Custom Git commit message for the asset branch publish
+- `--delivery` Production delivery mode: `cdn` or `inline`
 - `--asset-branch` Git branch used for published build artifacts and jsDelivr URLs
 - `--build-dir` Build output directory
 - `--notify` Show a desktop notification and play a sound when finished
@@ -400,11 +418,17 @@ Options:
 - `--force` Overwrite existing generated migration targets
 - `--publish` After writing local files, build assets, push the artifact branch, and update Webflow
 - `--custom-commit` Custom Git commit message for the generated migration publish
+- `--delivery` Delivery mode for `--publish`: `cdn` or `inline`
 - `--asset-branch` Git branch used for published build artifacts and jsDelivr URLs
 - `--build-dir` Build output directory
 - `--notify` Show a desktop notification and play a sound when finished
 
-`wfkit publish` always publishes only the built files in `buildDir` to the asset branch. `wfkit migrate --publish` uses that same artifact-only flow. Neither command commits or pushes your working tree source files.
+`wfkit publish` and `wfkit migrate --publish` support two delivery modes:
+
+- `cdn`: publish only the built files in `buildDir` to the asset branch, then point Webflow at jsDelivr
+- `inline`: build self-contained bundles and write them back into Webflow as managed inline module scripts
+
+Neither command commits or pushes your working tree source files.
 
 ### `wfkit update`
 

cmd/wfkit/app_commands.go

@@ -60,6 +60,7 @@ func buildMigrateCommand() *cli.Command {
 			&cli.BoolFlag{Name: "dry-run", Usage: "Show what would be migrated without writing files or updating Webflow"},
 			&cli.BoolFlag{Name: "publish", Usage: "After writing local files, build assets, push the artifact branch, and update Webflow"},
 			&cli.StringFlag{Name: "custom-commit", Value: "Migrate Webflow page code via wfkit", Usage: "Custom commit message"},
+			&cli.StringFlag{Name: "delivery", Value: "cdn", Usage: "Delivery mode for --publish: cdn or inline"},
 			&cli.StringFlag{Name: "asset-branch", Value: "wfkit-dist", Usage: "Git branch used for published build artifacts and jsDelivr URLs"},
 			&cli.StringFlag{Name: "branch", Hidden: true, Usage: "Deprecated alias for --asset-branch"},
 			&cli.StringFlag{Name: "build-dir", Value: "dist/assets", Usage: "Build directory"},
@@ -81,6 +82,7 @@ func buildPublishCommand() *cli.Command {
 			&cli.IntFlag{Name: "dev-port", Value: 5173, Usage: "Local dev server port (dev mode)"},
 			&cli.StringFlag{Name: "dev-host", Value: "localhost", Usage: "Local dev server host (dev mode)"},
 			&cli.StringFlag{Name: "custom-commit", Value: "Auto publish from wfkit tool", Usage: "Custom commit message"},
+			&cli.StringFlag{Name: "delivery", Value: "cdn", Usage: "Production delivery mode: cdn or inline"},
 			&cli.StringFlag{Name: "asset-branch", Value: "wfkit-dist", Usage: "Git branch used for published build artifacts and jsDelivr URLs"},
 			&cli.StringFlag{Name: "branch", Hidden: true, Usage: "Deprecated alias for --asset-branch"},
 			&cli.StringFlag{Name: "build-dir", Value: "dist/assets", Usage: "Build directory"},

cmd/wfkit/cli_helpers.go

@@ -56,6 +56,16 @@ func resolveAssetBranchFlag(c *cli.Context, fallback string) string {
 	return c.String("asset-branch")
 }
 
+func resolveDeliveryModeFlag(c *cli.Context, fallback string) string {
+	if c.IsSet("delivery") {
+		return c.String("delivery")
+	}
+	if fallback != "" {
+		return fallback
+	}
+	return "cdn"
+}
+
 func resolveIntFlag(c *cli.Context, name string, fallback int) int {
 	if c.IsSet(name) {
 		return c.Int(name)

cmd/wfkit/migrate_flow.go

@@ -37,22 +37,22 @@ func (f *migrateFlow) run() error {
 	}
 
 	f.printHeader()
-	printMigrateTimeline(f.dryRun(), f.shouldPublish(), false, false, false, false, false, false, false)
+	printMigrateTimeline(f.dryRun(), f.shouldPublish(), f.shouldPushAssets(), f.shouldPublish(), false, false, false, false, false, false, false)
 
 	if err := f.authenticate(); err != nil {
 		return err
 	}
-	printMigrateTimeline(f.dryRun(), f.shouldPublish(), true, false, false, false, false, false, false)
+	printMigrateTimeline(f.dryRun(), f.shouldPublish(), f.shouldPushAssets(), f.shouldPublish(), true, false, false, false, false, false, false)
 
 	if err := f.loadPages(); err != nil {
 		return err
 	}
-	printMigrateTimeline(f.dryRun(), f.shouldPublish(), true, true, false, false, false, false, false)
+	printMigrateTimeline(f.dryRun(), f.shouldPublish(), f.shouldPushAssets(), f.shouldPublish(), true, true, false, false, false, false, false)
 
 	if err := f.loadGlobalCode(); err != nil {
 		return err
 	}
-	printMigrateTimeline(f.dryRun(), f.shouldPublish(), true, true, true, false, false, false, false)
+	printMigrateTimeline(f.dryRun(), f.shouldPublish(), f.shouldPushAssets(), f.shouldPublish(), true, true, true, false, false, false, false)
 
 	if err := f.planMigration(); err != nil {
 		return err
@@ -66,14 +66,14 @@ func (f *migrateFlow) run() error {
 
 	if f.dryRun() {
 		utils.CPrint("Dry run mode: no files or Webflow code were changed", "yellow")
-		printMigrateTimeline(true, f.shouldPublish(), true, true, true, false, false, false, false)
+		printMigrateTimeline(true, f.shouldPublish(), f.shouldPushAssets(), f.shouldPublish(), true, true, true, false, false, false, false)
 		return nil
 	}
 
 	if err := f.writeFiles(); err != nil {
 		return err
 	}
-	printMigrateTimeline(false, f.shouldPublish(), true, true, true, true, false, false, false)
+	printMigrateTimeline(false, f.shouldPublish(), f.shouldPushAssets(), f.shouldPublish(), true, true, true, true, false, false, false)
 
 	if !f.shouldPublish() {
 		f.printSuccess()
@@ -83,12 +83,14 @@ func (f *migrateFlow) run() error {
 	if err := f.buildAssets(); err != nil {
 		return err
 	}
-	printMigrateTimeline(false, true, true, true, true, true, true, false, false)
+	printMigrateTimeline(false, f.shouldPublish(), f.shouldPushAssets(), f.shouldPublish(), true, true, true, true, true, false, false)
 
-	if err := f.pushGit(); err != nil {
-		return err
+	if f.shouldPushAssets() {
+		if err := f.pushGit(); err != nil {
+			return err
+		}
 	}
-	printMigrateTimeline(false, true, true, true, true, true, true, true, false)
+	printMigrateTimeline(false, f.shouldPublish(), f.shouldPushAssets(), f.shouldPublish(), true, true, true, true, true, f.shouldPushAssets(), false)
 
 	if err := f.publish(); err != nil {
 		return err
@@ -106,7 +108,7 @@ func (f *migrateFlow) loadConfig() error {
 	if cfg.AppName == "" {
 		return fmt.Errorf("missing appName configuration in wfkit.json")
 	}
-	if f.shouldPublish() {
+	if f.shouldPublish() && f.delivery() == "cdn" {
 		if err := cfg.ValidatePublish(); err != nil {
 			return err
 		}
@@ -116,6 +118,7 @@ func (f *migrateFlow) loadConfig() error {
 	f.pagesDir = resolveStringFlag(f.cliContext, "pages-dir", "src/pages")
 	f.args = map[string]interface{}{
 		"env":           "prod",
+		"delivery":      resolveDeliveryModeFlag(f.cliContext, cfg.DeliveryMode),
 		"asset-branch":  resolveAssetBranchFlag(f.cliContext, cfg.AssetBranch),
 		"build-dir":     resolveStringFlag(f.cliContext, "build-dir", cfg.BuildDir),
 		"custom-commit": f.cliContext.String("custom-commit"),
@@ -189,6 +192,20 @@ func (f *migrateFlow) writeFiles() error {
 
 func (f *migrateFlow) buildAssets() error {
 	utils.CPrint("Building migrated pages...", "cyan")
+	if f.delivery() == "inline" {
+		if err := build.RunProjectBuild(f.args["build-dir"].(string), f.config.PackageManager); err != nil {
+			return fmt.Errorf("build failed after migration: %w", err)
+		}
+		inlineBundles, err := build.BuildInlineBundles(f.args["build-dir"].(string), f.config.PackageManager)
+		if err != nil {
+			return fmt.Errorf("inline bundle build failed after migration: %w", err)
+		}
+		f.args["inline-global"] = inlineBundles.Global
+		f.args["inline-pages"] = inlineBundles.Pages
+		utils.CPrint("Build successful, inline bundles are ready for Webflow", "green")
+		return nil
+	}
+
 	scriptURL, err := build.DoBuild(f.args, f.config.GitHubUser, f.config.RepositoryName, f.config.PackageManager)
 	if err != nil {
 		return fmt.Errorf("build failed after migration: %w", err)
@@ -243,15 +260,16 @@ func (f *migrateFlow) publish() error {
 func (f *migrateFlow) printSuccess() {
 	if f.shouldPublish() {
 		printMigrationPublishResult(f.result)
-		printMigrateTimeline(false, true, true, true, true, true, true, true, f.result.Published)
+		printMigrateTimeline(false, f.shouldPublish(), f.shouldPushAssets(), f.shouldPublish(), true, true, true, true, true, f.shouldPushAssets(), f.result.Published)
 
 		notifySuccess(f.args["notify"].(bool), "wfkit migrate completed", "Webflow code migration finished successfully.")
 
 		utils.PrintSuccessScreen(
 			"Migration completed",
-			"Legacy Webflow code has been moved into local files and published via jsDelivr.",
+			"Legacy Webflow code has been moved into local files and published back to Webflow.",
 			[]utils.SummaryMetric{
 				{Label: "Pages updated", Value: fmt.Sprintf("%d", f.result.UpdatedPages), Tone: "success"},
+				{Label: "Delivery", Value: f.delivery(), Tone: "info"},
 				{Label: "Published", Value: map[bool]string{true: "yes", false: "no"}[f.result.Published], Tone: "info"},
 			},
 			"git status",
@@ -260,7 +278,7 @@ func (f *migrateFlow) printSuccess() {
 		return
 	}
 
-	printMigrateTimeline(false, false, true, true, true, true, false, false, false)
+	printMigrateTimeline(false, false, false, false, true, true, true, true, false, false, false)
 	notifySuccess(f.args["notify"].(bool), "wfkit migrate completed", "Webflow code migration files were written locally.")
 	utils.PrintSuccessScreen(
 		"Migration completed",
@@ -281,3 +299,11 @@ func (f *migrateFlow) dryRun() bool {
 func (f *migrateFlow) shouldPublish() bool {
 	return f.cliContext.Bool("publish")
 }
+
+func (f *migrateFlow) delivery() string {
+	return f.args["delivery"].(string)
+}
+
+func (f *migrateFlow) shouldPushAssets() bool {
+	return f.shouldPublish() && f.delivery() == "cdn"
+}