Convert UI code between frameworks into their native languages.
University Second Semester Project · Object-Oriented Programming
Paste your JavaFX Java code, get clean FXML out. Or go the other way.
UIPorter handles the conversion so you don't have to rewrite it manually.
🌐 Visit Website · 📦 Download · 📖 User Manual
🎬 Video
video.mp4
📸 Screenshots
- 🔄 Bidirectional Code Conversion - JavaFX Java ↔ FXML ↔ WinForms C#, in a single click
- 🧠 AI Assistant - Generate, improve, or convert UI code using Google Gemini
- 👁️ Live Preview - Compile and launch the converted JavaFX output as a real running window
- 🎨 Syntax Highlighting - Colour-coded Java and FXML editors powered by RichTextFX
- 📂 File I/O - Open
.java,.fxml,.csfiles directly; save output with the right extension - ⇄ One-Click Swap - Instantly flip source and target frameworks and re-convert
- ⚙️ Persistent Settings - API key and preferences saved automatically to
~/.uiporter/ - 📦 Self-Contained - No Java install needed to run; ships as a portable
UIPorter.exe
| From / To | JavaFX Java | FXML | WinForms C# |
|---|---|---|---|
| JavaFX Java | - | ✅ | ✅ |
| FXML | ✅ | - | ✅ |
| WinForms C# | ✅ | ✅ | - |
Converting between JavaFX Java ↔ FXML is the most accurate direction - same framework, just different syntax.
| Mode | What it does |
|---|---|
| 🖼️ Image → UI | Upload a screenshot or mockup → get JavaFX/FXML code |
| 💬 Prompt → UI | Describe a UI in plain text → generate a full layout |
| 🖥️ Console → GUI | Paste a console Java app → convert it to a GUI version |
| ✨ Improve UI | Paste existing UI code → AI enhances styling and layout |
- Go to Releases and download the latest
UIPorter-win.zip - Extract the zip anywhere
- Open the
UIPorter/folder - Double-click
UIPorter.exe- no installation or Java setup required
Want to use Live Preview? Preview compiles and runs real JavaFX code, so it needs a JDK installed on your system. Download JDK 25+ from Adoptium and make sure
javacis on your PATH. The rest of the app works without it.
- Get a API key from Google Cloud
- Open UIPorter → switch to the AI tab
- Paste your key into the API Key field - it saves automatically
Converting code:
- Select your source framework in the From dropdown
- Select the target in the To dropdown
- Paste your code into the left panel (or click Browse)
- Click → to convert
- The converted code appears on the right with syntax highlighting
- Click Copy or Save to use the output
Live Preview:
- Convert to JavaFX Java or FXML
- Click the 👁 Preview button - a real window opens showing the rendered UI
Swap direction:
- Click the ⇄ button to instantly flip source ↔ target and re-convert
| Category | Controls |
|---|---|
| Basic | Button, Label, TextField, TextArea, PasswordField |
| Selection | ComboBox, ChoiceBox, CheckBox, RadioButton |
| Display | ListView, TableView, TreeView |
| Navigation | TabPane / Tab, MenuBar / Menu / MenuItem |
| Layout | VBox, HBox, BorderPane, GridPane, StackPane, FlowPane, SplitPane, ScrollPane |
| Range | Slider, ProgressBar, ProgressIndicator, Spinner |
| Media | ImageView |
| Shapes | Rectangle, Circle, Ellipse, Line, Polygon |
| Charts | LineChart, BarChart, AreaChart, PieChart |
| Other | Accordion / TitledPane, Separator, Canvas, Tooltip, DatePicker, ColorPicker |
Properties preserved: text, colours, fonts, sizes, positions, padding, borders, alignment, visibility, event handlers, data lists, tree structures, table columns/rows, opacity, tooltips, inline CSS
UIPorter is built around an Intermediate Representation (IR) pattern:
Source Code → parse() → AppMetadata (IR) → generate() → Target Code
Every adapter converts into the neutral AppMetadata model first, then out of it.
Adding a new framework only requires writing one new adapter class, nothing else changes.
Design patterns used: Adapter · Singleton · Strategy · Open/Closed Principle
| Document | Description |
|---|---|
| Features & Working | What UIPorter does and how it works |
| Algorithms & Steps | Development steps and core algorithms |
| UML Class Diagram | Full class structure |
| Use Case Diagrams | All 5 use cases |
| Sequence Diagram | Conversion flow sequence |
| User Manual | Step-by-step usage guide |
| Limitations | Known limitations |
| Addressing Limitations | How they are handled |
| Requirement | |
|---|---|
| OS | Windows 10 / 11 (64-bit) |
| Run the app | Nothing - JVM is bundled in the release |
| Live Preview | JDK 25+ with javac on PATH |
| AI features | Internet connection + Google Gemini API key |
This project is developed for educational purposes as part of a university OOP semester project.