Create a new project

Create a new project

The most straightforward way to start a new project with Tuist is to use the tuist init command. This command launches an interactive CLI that guides you through setting up your project. When prompted, make sure to select the option to create a “generated project”.

You can then edit the project running tuist edit, and Xcode will open a project where you can edit the project. One of the files that are generated is the Project.swift, which contains the definition of your project. If you are familiar with the Swift Package Manager, think of it as the Package.swift but with the lingo of Xcode projects.

import ProjectDescription

let project = Project(
    name: "MyApp",
    targets: [
        .target(
            name: "MyApp",
            destinations: .iOS,
            product: .app,
            bundleId: "dev.tuist.MyApp",
            infoPlist: .extendingDefault(
                with: [
                    "UILaunchScreen": [
                        "UIColorName": "",
                        "UIImageName": "",
                    ],
                ]
            ),
            sources: ["MyApp/Sources/**"],
            resources: ["MyApp/Resources/**"],
            dependencies: []
        ),
        .target(
            name: "MyAppTests",
            destinations: .iOS,
            product: .unitTests,
            bundleId: "dev.tuist.MyAppTests",
            infoPlist: .default,
            sources: ["MyApp/Tests/**"],
            resources: [],
            dependencies: [.target(name: "MyApp")]
        ),
    ]
)

We intentionally keep the list of available templates short to minimize maintenance overhead. If you want to create a project that doesn’t represent an application, for example a framework, you can use tuist init as a starting point and then modify the generated project to suit your needs.

Manually creating a project

Alternatively, you can create the project manually. We recommend doing this only if you’re already familiar with Tuist and its concepts. The first thing that you’ll need to do is to create additional directories for the project structure:

mkdir MyFramework
cd MyFramework

Then create a Tuist.swift file, which will configure Tuist and is used by Tuist to determine the root directory of the project, and a Project.swift, where your project will be declared:

import ProjectDescription

let project = Project(
    name: "MyFramework",
    targets: [
        .target(
            name: "MyFramework",
            destinations: .macOS,
            product: .framework,
            bundleId: "dev.tuist.MyFramework",
            sources: ["MyFramework/Sources/**"],
            dependencies: []
        )
    ]
)

import ProjectDescription

let tuist = Tuist()

Tuist uses the Tuist/ directory to determine the root of your project, and from there it looks for other manifest files globbing the directories. We recommend creating those files with your editor of choice, and from that point on, you can use tuist edit to edit the project with Xcode.