diff --git a/Makefile b/Makefile index 3062993..b40bd1f 100644 --- a/Makefile +++ b/Makefile @@ -29,7 +29,7 @@ VERSIONED_JS := static/sf/sf.$(VERSION).js # ============== Phony Targets ============== .PHONY: banner help assets build build-release test test-quick test-doc test-unit test-one \ lint fmt fmt-check clippy ci-local pre-release version package-verify \ - bump-patch bump-minor bump-major bump-dry \ + bump-patch bump-minor bump-major bump-dry demo-serve \ publish-dry publish clean watch # ============== Default Target ============== @@ -251,12 +251,19 @@ watch: @printf "$(ARROW) Watching for changes...\n" @cargo watch -x build +demo-serve: assets + @printf "$(ARROW) Serving demos at http://localhost:8000/demos/\n" + @python3 -m http.server 8000 + # ============== Help ============== help: banner @/bin/echo -e "$(CYAN)$(BOLD)Asset Commands:$(RESET)" @/bin/echo -e " $(GREEN)make assets$(RESET) - Bundle CSS/JS from sources" @/bin/echo -e "" + @/bin/echo -e "$(CYAN)$(BOLD)Demo Commands:$(RESET)" + @/bin/echo -e " $(GREEN)make demo-serve$(RESET) - Serve the runnable demo fixtures locally" + @/bin/echo -e "" @/bin/echo -e "$(CYAN)$(BOLD)Build Commands:$(RESET)" @/bin/echo -e " $(GREEN)make build$(RESET) - Bundle assets + build crate" @/bin/echo -e " $(GREEN)make build-release$(RESET) - Bundle assets + release build" diff --git a/README.md b/README.md index 7a8aaaf..354fb58 100644 --- a/README.md +++ b/README.md @@ -516,6 +516,14 @@ Bundling writes both stable compatibility assets (`static/sf/sf.css`, `static/sf/sf.js`) and versioned assets (`static/sf/sf..css`, `static/sf/sf..js`). +## Demo Fixtures + +Runnable demo fixtures live in `demos/`. + +- `demos/full-surface.html` exercises the primary shipped component surface together. +- `demos/rail.html` focuses on resource cards, blocks, gauges, and changeovers. +- `make demo-serve` serves the repository at `http://localhost:8000/demos/` for local validation. + ## Acknowledgments solverforge-ui builds on these excellent open-source projects: diff --git a/demos/README.md b/demos/README.md new file mode 100644 index 0000000..ff11db6 --- /dev/null +++ b/demos/README.md @@ -0,0 +1,22 @@ +# Demo Fixtures + +These fixtures are intended to validate the shipped `solverforge-ui` surface locally. + +## Start a local server + +From the repository root: + +```bash +make demo-serve +``` + +Then open: + +- `http://localhost:8000/demos/` +- `http://localhost:8000/demos/full-surface.html` +- `http://localhost:8000/demos/rail.html` + +## Coverage + +- `full-surface.html`: header, status bar, tabs, buttons, modal, toast, table, rail, Gantt, API guide, and footer +- `rail.html`: resource header, cards, gauges, blocks, and changeovers diff --git a/demos/full-surface.html b/demos/full-surface.html new file mode 100644 index 0000000..22a1450 --- /dev/null +++ b/demos/full-surface.html @@ -0,0 +1,315 @@ + + + + + + solverforge-ui full surface demo + + + + + + + + + + + + + diff --git a/demos/index.html b/demos/index.html new file mode 100644 index 0000000..e4db872 --- /dev/null +++ b/demos/index.html @@ -0,0 +1,40 @@ + + + + + + solverforge-ui demos + + + + + + +
+
+

solverforge-ui demo fixtures

+

These fixtures exercise the shipped component surface using the bundled assets from this repository.

+
+
+

Full Surface

+

Header, status bar, tabs, table, modal, toast, API guide, rail, footer, and Gantt in one runnable fixture.

+ Open full-surface demo +
+
+

Rail Focus

+

A smaller fixture for validating resource cards, gauges, changeovers, and positioned blocks.

+ Open rail demo +
+
+
+
+ + diff --git a/demos/rail.html b/demos/rail.html new file mode 100644 index 0000000..ada16c7 --- /dev/null +++ b/demos/rail.html @@ -0,0 +1,107 @@ + + + + + + solverforge-ui rail demo + + + + + + + +
+
+
+ + + +