• allow declaring path parameters for ui.page like with ui.get (#105)
• improved javascript execution (#112)
• exceptions during page creation now present a "nice" 500 page (#119)
• provided more complex examples (#90)
• fixed infinite loops created by timers on individual pages for each connection (#118)

fixed and improved lifecycle example (see #103)

• show a few simple examples on the nicegui.io index page
• 3d scene example
• merged code improvement with MixIns from @hroemer (#113)
• bugfixes

• introduce the yield keyword as an alternative way for defining code that should be executed on-page-ready
• reduce CPU usage of line plot demo

Several optimizations to keep the online docs at https://nicegui.io available. Thanks for all the visits to our page. It really points out opportunities to improve the performance.

• create gaps via tailwind class instead of CSS style (see #104)
• raising exception for javascript execution if page is not ready (see #112)
• more examples
• improved documentation

• fix props and style parsing for certain edge cases

• improve style and props parsing to support multi-word props; now you can write .props('name="some multi-word value"') (see #98)
• testing joystick behaviour and styling with integration tests
• fixed auto-screenshot in integration tests

• allow tuples as keys in ui.select, ui.toggle and ui.radio
• improved test infrastructure (including screenshots)
• fixed default ui.joystick

fixed page registration (#100)

• added missing file to docker image

• minor documentation improvements
• fixed scrolling to anchor tag for main.py
• fixed persistence of traffic data for main.py

• auto-context for on_page_ready (see example)
• main.py: load api documentation and examples on_page_ready: This reduces the time to first byte.
• ValueElement now has a set_value method
• improved traffic chart on main.py

• functions decorated with @ui.page can optionally receive a request object
• new example to show working with the request object to implement authentication: examples/authentication

• improved styleability of joystick
• better naming of header/footer for customised pages
• add test for customised page
• provide access to justpy view within customised pages

• The @ui.page decorator is now a class. This enables you to encapsulate common styling and behaviour for all pages. See the customisation example for further details.
• Pytests are now executed as GitHub Action for every push.

• using private page generator for main.py
• fix style definitions with trailing semicolon #93
• test/demo for on_page_ready callback (see #50 and #94)

New Way to Define Pages

Pages are not created through a contextmanager anymore. Instead a decorator is used to configure a page builder. This is much closer to FastAPI and the existing get-decorator.

Example:

@ui.page('/')
def index_page():
    ui.label('Hello, world!')

It also allows us to create private pages: Before this change, it was quite complicated to not share all state with all browsers (eg. dialogs and menus). See https://nicegui.io/#page for documentation and #85 for more details on the decision process.

Other Changes

• introduced Selenium based pytests
• only update class, style and props if they have changed

The UI is now stoppable with ui.shutdown (see #83). Example:

from nicegui import ui

ui.label('Your UI...')
ui.button('Quit', on_click=ui.shutdown)
ui.run(reload=False)

print('Do something else...')

traffic chart: ignore our own monitoring requests

• split uvicorn reload arguments into list of strings to fix #62
• fixing poetry installation in development dockerfile

• Using uvicorn >= 0.18.0 (fixes #80).
• Allow upgrading JustPy to 0.2.x (fixes #80). Later versions of JustPy have not been tested. There are quite a lot of changes which have not been tested.
• Moving from watchgod to watchfiles package. Seems to have no effect on #62.
• bugfixes

adding traffic statistics to main.py

allow 4.0 and later versions of the typing-extensions package (see #78)

• list of markdown2 extensions is now configurable; activate "tables" by default
• updated dependencies

• provide optional socket in page.on_disconnect
• replaced "interactive mode" with simpler solution (see #71 and #74)

Changes

• re-organized, simplified and improved examples
• removed ui.svg because its just ui.html

Bugfixes

• update page after a websocket connected (in case it missed a ui update)
• update parent element when adding element to main page (without entering/exiting a context)
• use page from parent view instead from page stack to solve (#70)
• fixed font when running behind reverse proxy with prefixed path (#64)
• other minor fixes

• docker image now based on python 3.10
• minor documentation fixes

• introducing on_page_ready callback for ui.page
• bugfies
  • made sure our own print statements are shown
  • fixed rendered texture side
  • added missing ui update for markdown
  • cleaner DOM for ui.notify

• introduction of scene.text and scene.text3d to render text in 3d
• fixed timer update behaviour

• introducing disconnect-handlers for ui and page
• timer.interval is now a bindable property
• removed support for the obsolete keypress event
• improved documentation
• fixed firefox update issues and other bugfixes

From 0.8 onwards we changed the update strategy of NiceGUI:

Prior to this release, we used and propagated the same strategy as JustPy: event handlers needed to return False to not trigger full page updates. This works good for small examples. But if your UI gets bigger, full page updates become a real performance bottle neck. Adding return False everywhere is quite cumbersome and error prone. Instead, NiceGUI now smartly updates only the element which changes. And for cases where it can not simply detect a change the user can use ui.update(...) to enforce an update. See our documentation for more details and examples.

• introducing ui.add_head_html() and ui.add_body_html()
• updated lifecycle example to include ui.on_connect

• ability to exclude features to speed up loading time
• removed pydantic dependency
• improved console output on start
• lots of bugfixes

• allow awaiting javascript code
• fix camera movement
• introduce ui.add_static_files for serving a static folder
• fix main file detection for PyCharm

• introduction of ui.tree to display a hierarchy of elements
• introduction of ui.color_picker
• updated dependencies

• improve behavior of ui.link and ui.open as well as routing of static resources when NiceGUI is served with X-Forwarded-Prefix header

• introduce scene.ring, scene.tube and scene.spotlight for 3d scenes
• allow changing rendered material side for 3d objects
• allow hiding 3d objects
• introduce ui.table using AG Grid
• allow chaining tooltip() method via builder pattern
• allow nesting elements within ui.link
• bugfixes

• README with badges
• GitHub ribbon on https://nicegui.io
• improved examples and headlines in README

• introduce ui.expansion element
• ui.dialog is now awaitable
• adding .tooltip(...) for all ui.elements
• allow changing joystick style
• scale img to fill the whole interactive image element
• limit watchgod to python files by default
• disable input event to avoid page updates while typing
• smaller bugfixes
• cleanup

• introducing parameters to fine-control reload_dir and include/exclude patterns
• allow setting initial camera position within ui.scene
• bugfixes

we do not need the "binding" package

• let ui.open() use socket argument if it is not None

• make socket parameter optional for ui.open
• allow passing a page as target for ui.open

• remove obsolete hint about Heroku

• print hint about Heroku setup
• allowing to set host and port via environment variables
• making refresh interval for bindings configurable

• start NiceGUI in interactive mode (without auto-reload) if ui.run is not found or cannot be pre-evaluated

• allow binding to value properties
• fixing view update issues

• renamed ui.annotation_tool to ui.interactive_image to have a better name for the newly introduced features
• allow changing of image source for ui.interactive_image
• allow changing texture urls in ui.scene
• fixed auto-reload not working due to running timer

• parameter injection for get decorator
• upgraded dependencies

minor corrections improving demo page and documentation

• introducing on_request callback for pages to provide session info (this allows reauthentication through cookies)
• mouse handler in ui.annotation_tool is now optional
• allow styling of ui.annotation_tool with tailwind and css
• use more default styling for ui.chart
• bug fixes