Casual UI Toolkit

1. Import the package. Open the demo scene Sample/Scenes/CasualUIToolkitSample.unity.
2. Open Tools > Ostryzhnyi > CasualUIToolkit > Setup UI.
3. In the style bar, click Create Active Style Pointer. This creates Assets/CasualUIToolkitGenerated/Resources/Ostryzhnyi/CasualUIToolkit/ActiveStyle.asset.
4. In the Style dropdown pick one of the shipped styles (ReferenceStyle, ArcadeGreen, NeonPurple, SolarYellow), or click + and enter a name in the Create style window to create a copy of ReferenceStyle.
5. Every recolour widget in open scenes and in Play Mode repaints at once. Prefab files on disk keep the colours stored in them; the change is live only while widgets are enabled (see Apply pass).
6. Open the Motion tab to tune the animation profiles. The asset is created on first open.

Switching the style and driving the motion components from code:

using Ostryzhnyi.CasualUIToolkit;
using UnityEngine;

public class Example : MonoBehaviour
{
    [SerializeField] private AppStyle _style;
    [SerializeField] private CasualProgressBar _progress;
    [SerializeField] private CasualSwitch _switch;
    [SerializeField] private CasualBurst _burst;
    [SerializeField] private CasualCounter _counter;
    [SerializeField] private CasualPopup _popup;

    private void Start()
    {
        ActiveStyle.Instance.Style = _style;      // every live RecolourWidget repaints

        _progress.ReachedFull += () => Debug.Log("done");
        _progress.SetValue(0.75f);                // animates to 75%
        _switch.SetValue(true, animate: true, notify: false);
        _burst.Play(Vector2.zero, count: 12);     // stars from a point in the burst rect
        _counter.AddAnimated(50, arrivals: 10);   // rolls in ten steps as arrivals are reported
        StartCoroutine(_popup.Show());
    }
}

ActiveStyle.Instance is null until the pointer asset exists under a Resources folder (step 3).

Namespace Ostryzhnyi.CasualUIToolkit. Protected virtual lifecycle methods (Awake, OnEnable, Update, ...) are overridable but not listed. Every motion component resolves its profile as: own ProfileOverride, else the project MotionSettings profile, else a built-in default.

Styles

ActiveStyle

Responsible for: pointing the project at its current AppStyle. ScriptableObject, menu Ostryzhnyi/Casual UI Toolkit/Active Style.

StyleResolver

Responsible for: choosing between a widget's assigned style and the active style.

AppStyle

Responsible for: one complete theme, one ElementStyle per element type. ScriptableObject, menu Ostryzhnyi/Casual UI Toolkit/App Style. Missing sub-styles are created in memory on enable/validate. Button.Text is always linked to the style's Text.

ElementStyle

Responsible for: base of every per-type style; abstract ScriptableObject.

Element style types

All derive from ElementStyle, are ScriptableObjects and have a create menu entry Ostryzhnyi/Casual UI Toolkit/Element Styles/<Name> Style. Each property is a StyleColor unless noted. Flat-only slots always return flat mode. Slots marked "declared only" report true from TryGetColor only when a swatch name is set or alpha is above zero (so styles saved before the slot existed are left untouched).

StyleSlot

Enum, values in order (only ever appended, serialized as integers): Base, Texture, Shadow, Outline, Main, Color, Icon, ColoredShadow, Background, BackgroundShadow, DarkElements, OutlineIn, Fill, Pattern, Text, BodyText.

StyleColor

Responsible for: one slot value, either a flat colour or a gradient. [Serializable] struct.

Enums: StyleColorMode (Flat, Gradient), GradientDirection (Horizontal, Vertical).

Attributes

• FlatColorOnlyAttribute - the StyleColor field has no gradient mode.
• PreserveAlphaAttribute - assigning a swatch keeps the slot's alpha.
• OptionalOverrideAttribute - draws an object field behind an Override toggle.

Palette

• Palette (ScriptableObject, menu Ostryzhnyi/Casual UI Toolkit/Palette): Groups (List<PaletteGroup>); TryFindSwatch(string swatchName, out PaletteSwatch swatch) returns false for an empty or unknown name.
• PaletteGroup (serializable): Name, Swatches (List<PaletteSwatch>); constructor PaletteGroup(string name).
• PaletteSwatch (serializable): Name, Value (StyleColor); constructor PaletteSwatch(string name, StyleColor value); ToSlotValue() returns a deep copy carrying the swatch name.
• TextMaterialPreset (serializable): Font (TMP_FontAsset), Material; constructors () and (TMP_FontAsset, Material).

Recolouring

RecolourWidget

Responsible for: painting the graphics listed in Layers from the element style its StyleKind selects. MonoBehaviour, [ExecuteAlways], one per object. Repaints on enable, on ActiveStyle change and when the resolved style changes.

RecolourStyleKind: Button, Window, Icon, Label, Card, Control, Background, Dim, Glow (append-only).

AllowedSlots by kind: Button - Base, Texture, Shadow, Outline, Icon, ColoredShadow; Window - Main, Shadow, ColoredShadow, Text, BodyText; Icon - Color, Shadow; Label - Main, ColoredShadow, Shadow, Background, BackgroundShadow, DarkElements; Card - Base, Texture, Shadow, Outline, Text; Control - Shadow, Outline, OutlineIn, Background, Fill; Background - Base, Pattern; Dim and Glow - Main.

RecolourLayer

[Serializable] class pairing one graphic with one slot. Constructors () and (Graphic graphic, StyleSlot slot).

SetAppliedColor(Color) stores a colour and sets HasAppliedColor. The colour lives on the layer rather than on the graphic because live painting tints through the renderer, which multiplies with the graphic's own colour.

RecolourText

Responsible for: painting a TMP text from the global Text or Title style. MonoBehaviour, [ExecuteAlways], one per object.

Paint() (virtual) sets the text colour and, for a TitleStyle, its baked material when it matches the font's atlas; for other styles the material preset for the text's font, else the font's material.

GradientImage

Image subclass (Add Component > UI > Ostryzhnyi > Casual UI Toolkit > Gradient Image) that writes rect-normalised coordinates to uv1 so one ramp spans a sliced or atlas-packed graphic. It adds TexCoord1 to the parent canvas's additional shader channels (a canvas-wide setting).

GradientRamp

Static. Sample(Gradient gradient, int resolution) returns resolution colours from time 0 to 1 inclusive; throws ArgumentNullException for a null gradient and ArgumentOutOfRangeException for a resolution below 2.

Motion profiles

MotionProfile is the abstract ScriptableObject base. MotionSettings (menu Ostryzhnyi/Casual UI Toolkit/Motion Settings) holds one profile per type: Instance (static, loaded from Resources/Ostryzhnyi/CasualUIToolkit/MotionSettings, may be null), Changed, Invalidate() (static, clears the cached lookup), and properties Button, Switch, Toggle, ProgressBar, Popup, Idle, Nope, Particles, Glow, Burst, StarSequence, FlyToTarget, Counter, Shine, Entrance, ProgressSpark, plus DimAmount (default 0.6, 0-1; amount graphics are dimmed to while a switch is off or a control is disabled).

MotionProfileResolver.Resolve<T>(T overrideProfile, T projectProfile) returns the override, else the project profile, else a cached hidden built-in instance.

Defaults (properties are the capitalised field names; Easy values come from Core's tween library):

All motion runs on unscaled time, so it keeps playing at Time.timeScale 0.

Controls

Every control component below sits beside a native Selectable and animates its Layers child, never the root, so the hit area does not move. Each has ResolvedProfile (its profile type) and, except where noted, ProfileOverride.

CasualButton

Responsible for: hover, press and release motion of a button or card. Requires Button; forces the button's transition off. Implements pointer and selection handlers (OnPointerEnter, OnPointerExit, OnPointerDown, OnPointerUp, OnSelect, OnDeselect, all virtual).

While the button's own interactable is false, its motion is left to CasualDisabledFeedback. Keyboard or gamepad selection shows the hover treatment.

CasualSwitch

Responsible for: slide and stretch of a switch knob. Requires Toggle; clears the toggle's transition and checkmark graphic. Moves Bar between the track ends computed from the current rect (a resize keeps the knob flush) and dims it while off through DimChannel. A value set with SetIsOnWithoutNotify is picked up on the next frame without animation.

CasualToggle

Responsible for: checkmark pop/shrink and box wobble of a checkbox. Requires Toggle. Do not assign CheckIcon as Toggle.graphic; the native toggle fades that graphic and fights the tween.

SetValue(bool value, bool animate = true, bool notify = true) as for CasualSwitch.

CasualProgressBar

Responsible for: a 0-1 bar that grows with overshoot and punches when it reaches 1. Drives Bar's right anchor within its track.

SetValue(float value, bool animate = true): clamps to 0-1; without animate the bar snaps and Settled fires immediately.

CasualDisabledFeedback

Responsible for: dimming a non-interactable control and refusing its clicks with a squash and shake. Requires a Selectable; sits beside CasualButton, CasualSwitch or CasualToggle. Polls the control's own interactable flag each frame; a non-interactable parent CanvasGroup does not count. Members: Layers (Transform, graphics under it are dimmed and it is shaken), ActivitySignal, ResolvedProfile (NopeMotionProfile), OnPointerClick(PointerEventData) (virtual).

CasualShine

Responsible for: a periodic light band swept across a button. Requires a Selectable; pauses while it is not interactable.

Popups and screens

CasualPopup

Responsible for: a cascade open and an anticipating close. Owns one transition coroutine; calling Show() during a close (or the reverse) reverses from the current pose without a snap.

CasualPopupStrategy

Responsible for: using a CasualPopup as the animation strategy of an EasyViewService BaseView (derives from BaseAnimationStrategy). Put it beside the BaseView.

CasualStaggerEntrance

Responsible for: popping a list of targets into view in order whenever its object is enabled.

CasualStarSequence

Responsible for: stamping earned stars into their slots one by one with a shake and a spark burst. Slots reset to the empty look on enable.

Play(int earned) clamps earned to 0-StarSlots.Count and starts the sequence.

CasualEdgeFade

Responsible for: fading content to transparent along one edge of a RectMask2D (requires one).

Changing either applies immediately. The component adds a CanvasGroup to each direct child so the fade reaches zero alpha at the edge.

Ambient motion

CasualIdle

Responsible for: an attention bob on unscaled time that yields to every one-shot motion. Pauses while any sibling motion component's ActivitySignal is active, and resumes from phase zero.

Play() starts or resumes the loop; Stop() halts it and returns Layers to rest.

CasualGlowMotion

Pulses a glow's CanvasGroup.alpha and sways its Z rotation, on a channel separate from recolouring. Requires CanvasGroup. Restores the authored alpha and rotation on disable; does nothing outside Play Mode. Members: ProfileOverride, ResolvedProfile (GlowMotionProfile).

CasualParticles

A pooled uGUI background-particle emitter. Requires Canvas. Sprites and colour come from the active style's Particles; timing comes from ParticlesMotionProfile. With Prewarm on it starts with a full steady-state population. Members: ProfileOverride, ResolvedProfile.

Effects

CasualBurst

Responsible for: one-shot star or ray particles from a point. Colour comes from the active style's Glow unless given.

CasualCounter

Responsible for: a TMP number that rolls to new values with an icon punch per arrival.

CasualFlyToTarget

Responsible for: reward icons that burst out of a point and fly in an arc to a CasualCounter's icon; each arrival calls Counter.NotifyArrival().

CasualProgressSpark

Tracks a progress bar's fill edge, sheds stars while it advances and bursts at full.

WaitForCompletionEffect() returns an IEnumerator that waits until the full-value effect has finished.

Motion helpers

Public building blocks used by the components; most projects do not call them.

Sample types

Assembly Ostryzhnyi.CasualUIToolkit.Sample, namespace Ostryzhnyi.CasualUIToolkit.Sample (views: .Views). Not part of the toolkit API; safe to delete.

• SampleFlow (MonoBehaviour): Initialize(IViewService) and StartFlow() (virtual). Subscribes to every view's events and maps them to ShowView / HideView calls. Serialized Loading Duration (default 1 s). Starts the flow in Start, beginning with LoadingWindowView.
• SampleView : BaseView (abstract): helpers Listen / StopListening for buttons.
• FieldTapArea: raises LeftTapped or RightTapped by which half of the screen was clicked.
• Views, each raising events for its buttons: LoadingWindowView (Completed, Play(float duration)), MainMenuWindowView (PlayRequested, LevelRequested, LevelIdles, CurrentLevelIndex), BottomPanelView (DailyRequested, MissionRequested, ShopRequested, SettingsRequested), GameplayHudView (PauseRequested, LeftFieldTapped, RightFieldTapped, OutOfBoosterRequested), PausePopupView (CloseRequested, ContinueRequested, RestartRequested, SettingsRequested, ExitRequested), SettingsPopupView (CloseRequested, PrivacyPolicyRequested, TermsOfUseRequested), LevelCompletePopupView (ChestRequested, CloseRequested), LevelFailedPopupView (RetryRequested, ExtraTimeRequested, ExitRequested), ChestOpenPopupView (RewardRequested, GetKeysRequested), RewardPopupView (PlayRequested), DailyRewardPopupView (CloseRequested, RewardRequested), ShopPopupView, MissionPopupView (CloseRequested), OutOfBoosterPopupView (CloseRequested, BuyRequested, AdsRequested).