patx/veela
Add a screencast
Commit 2fc469e · patx · 2026-10-14T02:32:08-04:00
Comments
No comments yet.
Diff
diff --git a/README.md b/README.md
index 2a4d165..2b307ea 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,6 @@
# Veela
-<img src="https://patx.gitman.io/veela/veela-logo.png" alt="Veela, a magical gremlin mascot with long silver hair" width="180">
-
-A magical, single-file Python framework for simple JavaScript web apps.
+A magical, single-file Python framework for simple JavaScript web apps. [Watch the screencast!](https://viddler.com/embed/view?id=19966)
Website: <https://harrisonerd.com/veela>
@@ -182,12 +180,14 @@ Responses can also contain orjson-supported values such as UUIDs and datetimes.
The magic prefers to make its own introductions.
The app is still an ASGI callable, so you can run it with a separately installed
-ASGI server. That does involve installing something. We'll try to be brave.
+ASGI server. That does involve installing something. We'll try to be brave. That
+being said when deploying to the public no matter what server you use, always
+deploy behind nginx!
## For those who insist on looking inside
-The readable framework source lives in [source/veela.py](source/veela.py).
-The distributed [veela.py](veela.py) is generated. Please edit the former;
+The readable framework source lives in `source/veela.py`.
+The distributed `veela.py` is generated. Please edit the former;
the latter is enjoying a carefully curated lifestyle.
To regenerate it:
@@ -197,8 +197,7 @@ python scripts/build_embedded.py
```
The builder fetches hash-pinned wheels on the first run and reuses its cache
-afterward. Pins live in [scripts/embedded-lock.json](scripts/embedded-lock.json).
-This is a build step; users running the generated file don't need it.
+afterward. This is a build step; users running the generated file don't need it.
If you encounter a large encoded string, that's the innovation. Please don't
unfold it during the demo.
@@ -224,7 +223,9 @@ Based on [Wred](https://harrisonerd.com/wred), which had the good sense to stop
before this happened. Veela is the fork that kept going, encouraged by
absolutely nobody's requirements document.
-See [LICENSE](LICENSE) and [THIRD_PARTY_LICENSES.txt](THIRD_PARTY_LICENSES.txt)
+See `LICENSE` and `THIRD_PARTY_LICENSES.txt`
for the framework and bundled component licenses. The dependencies may have
achieved a higher plane of existence, but their license notices remain here
with the rest of us.
+
+<img src="https://patx.gitman.io/veela/veela-logo.png" alt="Veela, a magical gremlin mascot with long silver hair" width="180">
diff --git a/docs/branding-prompts.txt b/docs/branding-prompts.txt
deleted file mode 100644
index 5f0065a..0000000
--- a/docs/branding-prompts.txt
+++ /dev/null
@@ -1,12 +0,0 @@
-Veela branding image prompts
-Generated with the built-in ImageGen tool.
-
-Mascot design (reference: original Wred-embedded gremlin mascot):
-Use case: logo-brand. Reimagine the supplied old gremlin mascot as Veela: a funny charming FEMALE GREMLIN WITH VERY LONG SILVER HAIR, for a magical Python framework. This reference is the style and silhouette guide. Keep the reference mascot’s extremely simple chunky cartoon design, thick dark burgundy outlines, giant friendly eyes, huge pointed gremlin ears, mischievous open grin with a tiny fang, short rounded arms, stubby legs and big cartoon feet, raised mitten hand doing two golden sparkles. Female coding comes from big flowing silver-white hair reaching the feet, simple swept fringe and tiny eyelashes. A compact round red/rose little magical creature, about two heads tall, oversized head blending into simple squat body. Modest simple burgundy tunic if needed. Hair should be three or four big smooth graphic locks, NOT individually rendered strands. Pale cream face and silver hair with warm rose shadows; red/rose body; gold sparkles. Preserve the old logo’s friendly software-mascot simplicity and bold readable silhouette. Remove the old server vents, server light, paper corner and tape. No realistic woman, human anatomy, bust, cleavage, long human legs, elaborate robes, anime princess, jewelry, V symbol, monogram or letters. No text. Transparent background, square canvas, whole body and all hair comfortably inside with padding. The result should look like the old gremlin’s long-haired female cousin, not an elegant human fairy.
-
-Final palette edit (reference: generated long-haired gremlin):
-Use case: precise-object-edit. Recolor this exact long-haired female gremlin mascot into a new deep teal, sea-glass green, silver and warm gold brand palette. Preserve EXACTLY the character design, pose, silhouette, chunky proportions, giant eyes, pointed ears, mischievous fang grin, flowing long hair, tunic, mitten hands, feet, two sparkles and bold cartoon illustration style. Replace all red skin/body areas with sea-glass turquoise #66b8ac with darker teal shading. Replace burgundy outlines and eye color with deep midnight teal #133f48. Tunic deep teal #176b70. Hair stays silver-white, with pale cool mint shadows instead of pink. Face and inner ears pale mint-cream. Gold sparkles stay warm gold. No red, burgundy or pink anywhere. No new shapes, symbols, text, V mark or human anatomy. Keep full character and hair inside the square canvas with padding. Genuinely transparent background.
-
-Social card (reference: docs/veela-logo.png):
-undefined
-
diff --git a/docs/screencast.mp4 b/docs/screencast.mp4
new file mode 100644
index 0000000..67db1b1
Binary files /dev/null and b/docs/screencast.mp4 differ