UiPath Studio and Project Organization
Project anatomy
Studio offers project types: Process, Library (reusable components published as packages, no Main.xaml entry point in the same sense), Test Automation and Template, plus profiles (Studio, StudioX, Studio Pro). A process contains project.json (dependencies, target framework, entry point, project settings), Main.xaml as the default entry point, and supporting folders for workflows, screenshots and local settings. Publishing produces a NuGet package consumed by Orchestrator.
Choose the right container: a Sequence for linear, repeated steps; a Flowchart for branching and looping logic that is easier to read visually; a State Machine for state-driven processes (REFramework is the canonical example). Break work into small workflows invoked with Invoke Workflow File, passing arguments with direction In, Out or InOut.
Traps
- Renaming or moving files in File Explorer instead of inside Studio, breaking references.
- Confusing a variable's container scope with an argument's direction.
- Forgetting that Invoke Workflow File runs synchronously and does not return a value unless you define Out arguments.
- Editing
project.jsonby hand or removing a dependency that activities still use.
Rule of thumb
One workflow, one responsibility. Name files VerbNoun (ProcessInvoice.xaml) and arguments with direction prefixes: in_Config, out_Result, io_TransactionNumber.