docs: introduce playful Pythonlings visual identity

Readme.md

@@ -1,14 +1,19 @@
-# Pythonlings
-
-[![PyPI](https://img.shields.io/pypi/v/pythonlings)](https://pypi.org/project/pythonlings/)
-[![Python](https://img.shields.io/pypi/pyversions/pythonlings)](https://pypi.org/project/pythonlings/)
-[![CI](https://github.com/abhiksark/pythonlings/actions/workflows/ci.yml/badge.svg)](https://github.com/abhiksark/pythonlings/actions/workflows/ci.yml)
-[![Downloads](https://img.shields.io/pypi/dm/pythonlings)](https://pypi.org/project/pythonlings/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-yellow)](LICENSE)
+<!-- Readme.md -->
+<p align="center">
+  <img src="docs/assets/branding/pythonlings-hero.png" alt="Pythonlings: Learn Python by fixing tiny broken programs." width="100%">
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/pythonlings/"><img src="https://img.shields.io/pypi/v/pythonlings" alt="PyPI package version"></a>
+  <a href="https://pypi.org/project/pythonlings/"><img src="https://img.shields.io/pypi/pyversions/pythonlings" alt="Supported Python versions"></a>
+  <a href="https://github.com/abhiksark/pythonlings/actions/workflows/ci.yml"><img src="https://github.com/abhiksark/pythonlings/actions/workflows/ci.yml/badge.svg" alt="Continuous integration status"></a>
+  <a href="https://pypi.org/project/pythonlings/"><img src="https://img.shields.io/pypi/dm/pythonlings" alt="Monthly PyPI downloads"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-yellow" alt="MIT license"></a>
+</p>
 
 Documentation: [pythonlings.abhik.ai](https://pythonlings.abhik.ai/)
 
-**Rustlings for Python — learn by fixing 292 tiny broken programs in your terminal.**
+**Learn Python by fixing tiny broken programs.**
 
 Pythonlings helps you learn Python by fixing small broken programs and watching
 checks rerun as you type. It is built for beginner Python practice, coding

docs/demo.tape

@@ -1,3 +1,4 @@
+# docs/demo.tape
 Output docs/assets/demos/pythonlings-demo.gif
 
 Set Shell "bash"
@@ -22,6 +23,10 @@ Type "pythonlings"
 Enter
 Sleep 3s
 
+# Dismiss first-run onboarding, then let the coding screen settle.
+Enter
+Sleep 500ms
+
 # Coding screen -> local Python reference (F5), then close it (Esc)
 Escape
 Type@0ms "[15~"

mkdocs.yml

@@ -1,3 +1,4 @@
+# mkdocs.yml
 site_name: Pythonlings
 site_url: https://pythonlings.abhik.ai/
 site_description: Python learnings, Rustlings-style, in a terminal TUI.
@@ -9,8 +10,8 @@ docs_dir: docs-site
 theme:
   name: material
   language: en
-  logo: assets/logo.svg
-  favicon: assets/favicon.svg
+  logo: assets/logo.png
+  favicon: assets/favicon.png
   font:
     text: Inter
     code: JetBrains Mono