diff --git a/‎.github/workflows/ci.yml‎
Lines changed: 1 addition & 1 deletion b/‎.github/workflows/ci.yml‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎CONTRIBUTING.md‎
Lines changed: 8 additions & 10 deletions b/‎CONTRIBUTING.md‎
Lines changed: 8 additions & 10 deletions
diff --git a/apps/pythonnative_demo/.gitignore renamed to examples/hello-world/.gitignore b/apps/pythonnative_demo/.gitignore renamed to examples/hello-world/.gitignore
diff --git a/apps/pythonnative_demo/README.md renamed to examples/hello-world/README.md b/apps/pythonnative_demo/README.md renamed to examples/hello-world/README.md
diff --git a/apps/pythonnative_demo/app/__init__.py renamed to examples/hello-world/app/__init__.py b/apps/pythonnative_demo/app/__init__.py renamed to examples/hello-world/app/__init__.py
diff --git a/apps/pythonnative_demo/app/main_page.py renamed to examples/hello-world/app/main_page.py b/apps/pythonnative_demo/app/main_page.py renamed to examples/hello-world/app/main_page.py
diff --git a/apps/pythonnative_demo/app/resources/.gitkeep renamed to examples/hello-world/app/resources/.gitkeep b/apps/pythonnative_demo/app/resources/.gitkeep renamed to examples/hello-world/app/resources/.gitkeep
diff --git a/apps/pythonnative_demo/app/second_page.py renamed to examples/hello-world/app/second_page.py b/apps/pythonnative_demo/app/second_page.py renamed to examples/hello-world/app/second_page.py
diff --git a/apps/pythonnative_demo/pythonnative.json renamed to examples/hello-world/pythonnative.json b/apps/pythonnative_demo/pythonnative.json renamed to examples/hello-world/pythonnative.json
diff --git a/apps/pythonnative_demo/requirements.txt renamed to examples/hello-world/requirements.txt b/apps/pythonnative_demo/requirements.txt renamed to examples/hello-world/requirements.txt
@@ -33,7 +33,7 @@ jobs:
 
       - name: Format check (Black)
         run: |
-          black --check src apps tests
+          black --check src examples tests
 
       - name: Type check (MyPy)
         run: |
 
@@ -20,7 +20,7 @@ pip install -e .
 pytest -q
 
 # format and lint
-black src apps tests || true
+black src examples tests || true
 ruff check .
 ```
 
@@ -33,8 +33,8 @@ pn --help
 # create a new sample app (template fetch is remote)
 pn init my_app
 
-# run a local demo app skeleton
-cd apps/pythonnative_demo && pn run android
+# run the Hello World example
+cd examples/hello-world && pn run android
 ```
 
 ## Project layout (high‑level)
@@ -44,9 +44,8 @@ cd apps/pythonnative_demo && pn run android
   - `cli/` – `pn` command
 - `tests/` – unit tests for the library
 - `templates/` – Android/iOS project templates and zips
-- `apps/` – application projects
-  - `django_pythonnative/` – Django project for docs/demo hosting and E2E
-  - `pythonnative_demo/` – minimal demo app using the library
+- `examples/` – runnable example apps
+  - `hello-world/` – minimal demo app using the library
 - `experiments/` – platform experiments (Android/iOS/Briefcase)
 - `README.md`, `pyproject.toml` – repo docs and packaging
 
@@ -62,7 +61,7 @@ Common commands:
 ```bash
 pytest -q                     # run tests
 ruff check .                  # lint
-black src apps tests          # format
+black src examples tests      # format
 ```
 
 ## Conventional Commits
@@ -107,11 +106,10 @@ Recommended scopes (match the smallest accurate directory/module):
 
 - Templates and examples:
   - `templates` – `templates/` (Android/iOS templates, zips)
-  - `demo` – `apps/pythonnative_demo/`
+  - `examples` – `examples/` (e.g., `hello-world/`)
   - `experiments` – `experiments/`
 
-- Django app and site:
-  - `django` – `apps/django_pythonnative/` (site, docs pages, E2E harness)
+<!-- Django app and site removed: the old Django project has been retired -->
 
 - Repo‑level and ops:
   - `deps` – dependency updates and version pins