V1.0.0 A smaller, smooter, cleaner, clearer framework by ponsoc · Pull Request #23 · ponsoc/ststeroids

ponsoc · 2026-01-02T11:59:55Z

Partially rewritten the framework to reduce its footprint and make object creation more intuitive. Editor and debugger support has been improved, making development smoother and more productive. The router system has also been greatly enhanced, now supporting conditional routes directly within the framework, giving you more control over navigation and layout rendering.

Todo:

Update tests

…s the active route

…ating readme

Jamiefaber

Once logging in the setupflow prints and when i log in a gain the setupflow doesnt print anymore, works correctly

Jamiefaber · 2026-01-06T16:05:18Z

        self.password = st.text_input("Password", type="password")
        if st.button("Login", use_container_width=True):
-            self.login_flow.dispatch()
+            self.login_flow.dispatch() # via on click, doe hij dan wel een rerun/


Jamiefaber · 2026-01-06T16:06:13Z


        self.app = StSteroids()

+        # self.app.on_app_run_once(self.setup_flow)


Jamiefaber · 2026-01-06T16:17:10Z

        """
        self._routes[route.name] = route

+    def on_app_run_once(self, callback: Flow):


doc string + typehint

Jamiefaber · 2026-01-06T16:21:04Z

            )
+
+        if st.button("logout"):
+            del st.session_state["store"]["access_token"]


After pressing the log out button no login screen appears until I click somewhere else. An st.rerun would fix this for example.

Jamiefaber · 2026-01-06T16:29:37Z

-Registers a layout or page as a route in your app.
- name is the route identifier
- layout is the layout class or callable to render when this route is selected
+Registers a route that maps a route name to a layout class .


Registers a route that maps the route name to a layout class. space between point are class and the route name instead of a route name, reads nicer and name is an identifier right

Jamiefaber

Mainly spell check and documentation formatting. One comment about the app_setup flow which needs to be made sure that that is working as intended. Lastly, I also have comments on code which isn't new code, I think you didn't see them because of that. I also wasn't able to resolve my comments, so consider the comments you have replied to as resolved

Jamiefaber · 2026-01-07T15:34:22Z

+Component concepts:
+
+- components never decide on domain logic, so no domain error handeling for example
+- a component contains interaction elements, unless


components contain interaction elements, unless:

Jamiefaber · 2026-01-07T15:35:10Z

+
+- components never decide on domain logic, so no domain error handeling for example
+- a component contains interaction elements, unless
+    - the component is still meaningful and usable without a the interaction element → split the element out


the component is still meaningful and usable without the interaction element → split the element out

Jamiefaber · 2026-01-07T15:35:37Z

+- components never decide on domain logic, so no domain error handeling for example
+- a component contains interaction elements, unless
+    - the component is still meaningful and usable without a the interaction element → split the element out
+- a component doesn't navigate pages


components don't navigate pages

Jamiefaber · 2026-01-07T15:37:47Z

+- a component contains interaction elements, unless
+    - the component is still meaningful and usable without a the interaction element → split the element out
+- a component doesn't navigate pages
+- should have methods for updating it's attributes (explicit state changes) (so that the flow doesn't need to all the attributes)


should have methods for updating its attributes (this makes explicit state changes possible, so that the flow doesn't need to have all the attributes)

Jamiefaber · 2026-01-07T15:39:38Z

+- Flows coordinate multiple components and stores as part of a single interaction
+- Flows determine navigation and control flow between layouts or pages
+- Flows own error handling and recovery logic for the interactions they manage
+- Flows may contain light business rules, but core domain logic should live in services


The bullet points here all start with Flow with a capital F, above and below the component and layout start with lowercase letter. Make sure it is uniform, suggest starting with capitals and ending with dots

done, well catched>

Jamiefaber · 2026-01-07T16:39:55Z

 class Router:
    """
-    A routing system for Streamlit applications, allowing navigation between different pages.
+    A routing system for the framework, allowing navigation between different layouts.


Missing attributes

Jamiefaber · 2026-01-07T16:41:09Z

@@ -13,14 +13,13 @@ class Store:
    """


Store doc string has param, whereas it should be formatted as attributes

Jamiefaber · 2026-01-07T16:41:46Z

    """

    def __init__(self, store_name: str):
-        """


Why is this docstring removed?

Jamiefaber · 2026-01-07T16:42:44Z

 class ComponentStore(Store):
    """
-    Class that creates a component session store. This can be passed to component instances.
+    Class that creates a component session store.


Missing attributes?

Jamiefaber · 2026-01-07T16:43:53Z

@@ -15,7 +15,7 @@ def __init__(self, style_file: str):
        """
        self.style_file = style_file


Name style file as attribute in the class doc string

Aschwinvo · 2026-01-22T14:27:35Z

A smaller, SMOOTHER, cleaner, clearer framework

Aschwinvo · 2026-01-22T14:28:49Z

-    ):
+    ) -> None:
        """
        Executes the render method implemented in the subclasses, additionaly providing extra configuration based on the `render_as` parameter


render_as removed.

Jamiefaber · 2026-01-26T16:19:22Z

+from .flow import Flow
+
+
+class RouteBuilder:


Missing example where Routebuilder usage is shown, specifically the on_enter functionallity

ponsoc · 2026-02-06T08:38:24Z

no positional argument?

ponsoc added 30 commits December 17, 2025 09:22

First steps

412ef0e

Version bump

40a7bf5

Flow and layout are now abstract

ce15cf5

Component absract

58f077f

Cleaning the store

8b158ea

Sidebar is a component and should be in a layout, not in main app

489b63e

Second attempt

ae2d619

Review improvements

e91d374

Update README.md

b573115

Update refresh.py

2296175

Update metric.py

39da56e

No value in current route when properly using the router the layout i…

5fef8ab

…s the active route

Update layout.py

595912d

Update refresh.py

fba86fb

Update login_succes.py

2b606ff

Update component.py

fca3bfe

formatting

9833822

formatting

fd7676e

Resolving first comments

4e71ea9

Formatting and removing unused stuff

78e2b7f

Cleaning

65af69f

Added create methods for flow and layout

883a2f0

Introducing toast

535b8c3

Better naming

3ead59f

Some cleaning considered the new framework rules and started with upd…

fb75cd1

…ating readme

Update login.py

c891361

Cleaning and docs

6ed71ce

Update login.py

1df2ab5

improved visibility functionality

23ea5b2

doc strings and type hints

c468adb

Comments Jamie and event handlers for app and routes

4f9782b

Jamiefaber suggested changes Jan 6, 2026

View reviewed changes

Final changes, component events work now through events

82d1ea2

Jamiefaber suggested changes Jan 7, 2026

View reviewed changes

ponsoc added 5 commits January 8, 2026 09:07

Comments Jamie

c330813

Better flow context

b9c88d0

New Fragment and Dialog component types

c4c6ee2

Comments Jamie done

ded77d1

formatting

02efdc1

Aschwinvo reviewed Jan 22, 2026

View reviewed changes

Jamiefaber suggested changes Jan 26, 2026

View reviewed changes

ponsoc added 14 commits February 7, 2026 10:11

minor naming

7cfc0eb

update store tests

1b7df3a

update router tests

086bf9d

add and update all tests

a7a995c

formatting

3534b76

more formatting

2460e7f

missed a file

b547c39

fix minor bug and update test

ce7a54b

fix order

922f688

schedule and rerun

872ca97

Better way of working with the events

51034f2

Update test_component.py

2699b22

Improved tests and example app

6f7bd9d

Version and readme

c931551

ponsoc marked this pull request as ready for review March 6, 2026 12:02

ponsoc merged commit 9c897cf into main Mar 6, 2026
3 checks passed

ponsoc deleted the v1.0.0 branch March 6, 2026 12:11


		self.app = StSteroids()

		# self.app.on_app_run_once(self.setup_flow)

		@@ -15,7 +15,7 @@ def __init__(self, style_file: str):
		"""
		self.style_file = style_file

Conversation

ponsoc commented Jan 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Jamiefaber left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Jamiefaber left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Aschwinvo commented Jan 22, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ponsoc commented Feb 6, 2026

Uh oh!

Uh oh!

Reviewers

ponsoc commented Jan 2, 2026 •

edited

Loading