duck.etc.blueprints.welcome.ui.pages.welcome

WelcomePage — the page shown to new users upon installing Duck Framework.

Assembles the navbar, hero, stats ticker, features grid, code showcase, links section, and footer. Injects interactive JS for the cursor glow, particle field, count-up stats, and install-command copy button.

Module Contents

Classes

WelcomePage

The welcome / onboarding page shown after installing Duck Framework.

API

class duck.etc.blueprints.welcome.ui.pages.welcome.WelcomePage(request, disable_lively: bool = False, lazy: bool = True, *args, **kwargs)[source]

Bases: duck.html.components.page.Page

The welcome / onboarding page shown after installing Duck Framework.

Static and purely presentational — all interactivity (cursor glow, particles, count-up, copy button) runs client-side via injected JS, since this page is shown before any project-specific setup exists.

Initialization

Initialize the Page component.

Parameters:

  • request – The target HTTP request.

  • disable_lively – This disables Lively components for the page. Defaults to False.

  • lazy – This makes the page not aggressively load the page tree on initialization but let the system decide the right time to load the page. Defaults to True.

add_interactive_script() → None[source]

Injects the client-side JS powering all page interactivity.

Covers: floating particles, mouse-follow ambient glow, count-up stat animation on scroll, and the install command copy-to-clipboard behaviour.

build_background_layers() → duck.html.components.container.Container[source]

Returns the ambient background elements: glow orb, scan line, particle field, and mouse-follow glow.

Returns:

A Container holding all background decoration elements.

build_layout() → None[source]

Constructs the full page layout and adds it to the body.

build_section_label(text: str) → duck.html.components.container.Container[source]

Returns a small uppercase section divider label.

Parameters:

text – The label text to display.

Returns:

A Container styled as a section label.

interactive_js() → str[source]

Returns the full interactive JS block as a string.

Returns:

JavaScript source code.

on_create() → None[source]

Sets up SEO metadata, injects styles and scripts, and builds layout.