Techsenger StagePro

Support the Project!

This project is open-source and free to use, both commercially and non-commercially, which is why we need your help in its development. If you like it, please give it a star ⭐ on GitHub — it helps others discover the project and increases its visibility. You can also contribute, for example, by fixing bugs 🐛 or suggesting improvements 💡, see Contributing. If you can, financial support 💰 is always appreciated, see Support Us. Thank you!

Table of Contents

• Overview
• Demo
  • Light Theme
  • Dark Theme
• Features
• Limitations
• JavaFX Issues
• Dependencies
• Usage
• Code building
• Running Sampler
• License
• Contributing
• 👉 Support Us

Overview

Techsenger StagePro is a library that allows you to create custom stages with nearly any configuration, while remaining easy to use. The project also includes a sampler module, featuring key samples to help you get started with the library.

Demo

Light Theme

Dark Theme

Features

Key features include:

• Fully customizable title bar configurations.
• Support for dynamic configuration changes.
• Ability to place basic buttons on either the left or right side.
• Two maximize button policies.
• Styling via CSS.
• Dark mode support.
• SVG-based button icons.
• Only two events triggered during resizing (start and finish).

Limitations

• No shadow support. Currently, shadows for Stage are not supported as JavaFX provides no built-in way to render shadows around transparent windows. This would likely require platform-specific native code.
• No native window management features. Edge-based behaviors like Windows Snap Layouts and GNOME Edge Tiling cannot be properly implemented using Java alone. These features also require platform-specific native code.

JavaFX Issues

• Use JavaFX 16–20 or versions after 24-ea+19 due to known bugs (JDK-8344372).
• Resizing the stage via the top/left border causes jitter on the opposite side (JDK-8347155).

Dependencies

This project is available on Maven Central:

<dependency>
    <groupId>com.techsenger.stagepro</groupId>
    <artifactId>stagepro-core</artifactId>
    <version>${stagepro.version}</version>
</dependency>

Usage

To create a standard Stage, use the code below. To explore all features, check out the examples in the sampler.

@Override
public void start(Stage stage) {
    var controller = new StandardStageController(stage, 800, 600);
    var content = new VBox(...);
    controller.setContent(content);
    stage.show();
}

Code Building

To build the library use standard Git and Maven commands:

git clone https://github.com/techsenger/stagepro
cd stagepro
mvn clean install

Running Sampler

To run the sampler execute the following commands in the root of the project:

cd stagepro-sampler
mvn javafx:run

Please note, that debugger settings are in stagepro-sampler/pom.xml file.

License

Techsenger StagePro is licensed under the Apache License, Version 2.0.

Contributing

We welcome all contributions. You can help by reporting bugs, suggesting improvements, or submitting pull requests with fixes and new features. If you have any questions, feel free to reach out — we’ll be happy to assist you.

👉 Support Us

You can support us financially through GitHub Sponsors. Your contribution directly helps us keep our open-source projects active, improve their features, and offer ongoing support. Besides, we offer multiple sponsorship tiers, with different rewards.