BitFrames

A powerful, fluent, and modular UI animation library for Roblox. Create stunning visual effects with ease.

BitFrames is designed to be a better replacement for TweenService, offering two different tweening engines (Spring and Easing) and a suite of pre-made, optimized animations.

Features

• Fluent API: Chainable methods for clean and readable code.
• Dual Tween: Support for both physics-based Spring animations and standard Easing styles.
• Pre-made Effects: Includes a variety of built-in effects like Entrance, Exit, Attention, Loop, and Text animations.
• Optimized: Designed for performance with efficient memory management.
• Type Safe: Full Luau type support for better autocomplete and strict typing.

Installation

Wally

Append the following to your wally.toml:

[dependencies]
BitFrames = "risebit/bitframe@0.1.4"

Usage

Basic Example

local BitFrames = require(path.to.BitFrames)

local frame = script.Parent.Frame
local animator = BitFrames.new(frame)

animator:fadeIn({
    duration = 1,
    style = BitFrames.Easing.Quad,
    direction = BitFrames.Easing.Out,
}):play()

Chaining Effects

animator
    :fadeInUp()
    :wait(1)
    :pulse({ infinite = true })

Text Effects

local textLabel = script.Parent.TextLabel
local textAnimator = BitFrames.new(textLabel)

textAnimator:typewriter("Hello, World!", {
    speed = 0.05,
    cursor = "_"
})

API Overview

Constructors

• BitFrames.new(instance: GuiObject): BitFramesObject

Effect Categories

• Entrance: fadeIn, fadeInUp, scaleIn, dropIn, etc.
• Exit: fadeOut, fadeOutDown, scaleOut, shrinkOut, etc.
• Attention: pulse, shake, bounce, flash, jello, etc.
• Loop: spin, float, breathe, glow, etc.
• Text: typewriter, scramble, colorCycle, glitch, etc.

Tween Type

You can switch between engines in the configuration:

• Easing: Standard TweenService-like styles (Quad, Cubic, Elastic, etc.)
• Spring: Physics-based animations (damping, stiffness, mass)