Skip to content

Managing Project

To create a modeling project, press Ctrl+N or select File | New.

You can start a modeling project by selecting a template. To start a project with a template, select File | New From Template | [TemplateName]. StarUML supports the following default templates:

  • UML Minimal - A single model with UML Standard Profile.
  • UML Conventional - Use Case Model, Analysis Model, Design Model, Implementation Model, and Deployment Model with UML Standard Profile.
  • 4+1 View Model - Philippe Kruchten’s 4+1 Architectural View Model.
  • Rational - Approach of Rational Rose Tool.
  • Data Model - A simple data modeling project.
  • AWS Architecture, Azure Architecture, GCP Architecture - Cloud architecture diagrams.
  • BPMN Business Process Modeling - A business process model.
  • C4 Model - A C4 model.
  • Wireframe Model - A wireframe model.

If you don’t want to use pre-defined templates, you need to make your own project structure.

If you have model files (.mdj), you can open it in StarUML. To open a model file, press Ctrl+O or select File | Open… and then select a file in Open Dialog.

If the file was saved by an older version of StarUML, you will be asked whether to convert the colors of views into color variables. Select Convert to make the colors follow the light and dark themes, or Keep Colors to keep the colors as they are. See Color Variables.

If you have StarUML V1 model files (.uml), you can import by selecting File | Import | StarUML 1 File (.uml)….

You can save the working project into a file by pressing Ctrl+S or selecting File | Save. If you want to save as another file, press Ctrl+Shift+S or select File | Save As….

To close working project, select File | Close. If you didn’t saved the project, you will be asked to save or not.

To export a part of the project as a fragment, select File | Export | Fragment… and then select an element to export in Element Picker Dialog.

To save the project as a file that can be opened in StarUML V7, select File | Export | StarUML V7…. StarUML V7 does not support color variables, so the color variables of views are replaced with their colors in the light theme (see Color Variables). The working project and its file are not changed.

If you open the exported file in this version again, you will be asked whether to convert the colors into color variables, as with files saved by an older version.

To export the project as a set of HTML documents, select File | Export | HTML Docs… menu item.

To export diagrams as image files, press Ctrl+Shift+E (Cmd+Shift+E in MacOS) or select File | Export Image…. The Export Image dialog has the following options:

  • Range : Current Diagram or All Diagrams.
  • Format : PNG, JPEG or SVG.
  • Fill background : Fill the background with the background color of the current theme. JPEG images are always filled.
  • Scale : 1x or 2x. Not available for SVG.
  • Margin : The margin around the diagram (0 to 32 pixels).

Then click Export… to save the current diagram as a file, or Export All… (when Range is All Diagrams) to select a folder where all diagrams are saved. Click Copy to Clipboard to copy the current diagram as an image with the same options. The dialog stays open and shows the result, so click Close (or press Esc) to close it. The options are remembered for the next time.

Diagrams are exported with the colors of the current theme (light or dark).

To copy the current diagram as an image quickly, press Ctrl+Shift+C (Cmd+Shift+C in MacOS) or select Edit | Copy Diagram As Image.

To export diagrams as a PDF document, select File | Print to PDF…. You can select the range (all diagrams or the current diagram), the page layout, the page size and whether to show diagram names in Print Dialog (see Print Dialog).

To export the project as an XMI (XML Metadata Interchange) 2.1 file, select File | Export | XMI Export (v2.1)…. Only model elements are exported (diagrams are not included).

To import an XMI 2.1 file (e.g. exported by other UML tools), select File | Import | XMI Import (v2.1)…. The model elements in the file are imported in a new model XMIImported under the project. Diagrams are not imported.

To import a fragment into the project, select File | Import | Fragment…. The fragment will be included as a child of the project.

To include UML Standard Profile, select Model | Apply Profile | UML Standard Profile (v2) in Menu Bar.