v2: changelog, roadmap, and screenshots. #318

CHANGES.rst

@@ -18,13 +18,23 @@ Unreleased
 
 * Support PyPy 3.11. (:issue:`354`)
 
-* Return the ``source (feed)`` form of :attr:`Entry.feed_resolved_title`
-  only if the source and feed titles are different.
-
-* The :mod:`~reader._plugins.cli_status` plugin creates only one entry
-  per command, containing the output of all runs from the past day,
+* Start working on a web app :ref:`re-design <app roadmap>`
+  based on `htmx`_ and `Bootstrap`_,
+  beginning with a new version of the main entries page,
+  and dark mode support;
+  some :ref:`screenshots <app screenshots>`.
+  (:issue:`318`)
+
+* :attr:`Entry.feed_resolved_title`:
+  return both the source and feed titles only if they are different.
+
+* The :mod:`~reader._plugins.cli_status` plugin
+  now creates only one entry per command,
   with the newest run first.
 
+.. _htmx: https://htmx.org/
+.. _Bootstrap: https://getbootstrap.com/
+
 
 Version 3.16
 ------------

docs/app.rst

@@ -67,9 +67,34 @@ If running on a personal computer, you can use cron to run ``serve`` at boot::
 .. _Werkzeug's development server: http://werkzeug.pocoo.org/docs/0.14/serving/#werkzeug.serving.run_simple
 
 
+.. _app screenshots:
+
 Screenshots
 -----------
 
+Following are screenshots of the web app re-design
+mentioned in the :ref:`roadmap <app roadmap>`.
+For the legacy web app, see `Screenshots (legacy)`_.
+
+Main page
+~~~~~~~~~
+
+.. figure:: screenshots/entries-v2-dark.png
+    :width: 240px
+
+    main page (dark mode)
+
+.. figure:: screenshots/entries-v2-filters-light.png
+    :width: 240px
+
+    main page – more filters (light mode)
+
+
+Screenshots (legacy)
+--------------------
+
+Following are screenshots of the original (legacy) web app.
+
 Main page
 ~~~~~~~~~
 

docs/dev.rst

@@ -122,8 +122,14 @@ Long term, I'd like to:
 * switch to `htmx`_ instead of using a home-grown solution
 * spin it off into a separate package/project
 
-.. _htmx: https://htmx.org/
+**2025 update**:
+I've started working on a re-design based on `htmx`_ and `Bootstrap`_;
+some :ref:`screenshots <app screenshots>`.
+The new app will be available in parallel with the old one
+until it reaches feature parity.
 
+.. _htmx: https://htmx.org/
+.. _Bootstrap: https://getbootstrap.com/
 
 
 .. _compat: