"Make anywhere feel like yours. Just let it unfold."

A Swift-based CLI for managing and backing up your dotfiles. It helps you collect the configs you care about and sync them across your machines, structured exactly the way you want.

This is the 2nd project for the Swift Programming course, created to apply the fundamentals learned in the course.

It follows a strict, course-defined scope (see CHECKLIST.md for exact requirements).

Due to the submission deadline on March 5, 2026, some parts may be incomplete or experimental.

The project covers the following topics:

• Structures and Classes
• Properties
• Methods
• Subscripts
• Inheritance
• Initialization
• Deinitialization
• Optional Chaining
• Type Casting
• Nested Types

Lilac is inspired by the approach of chezmoi, a well-established dotfile management tool.

• Swift 6.2+
• macOS 15+

1. Clone the repository

git clone https://github.com/staciax/lilac-v0.git

2. Build the package

swift build

# init your dotfiles repository at ~/.local/share/lilac
lilac init

# add configs using presets
lilac add -p vscode
lilac add -p ssh

# add custom files or directories manually
lilac add ~/.vimrc
lilac add ~/my-scripts

Lilac uses TOML files for configuration. It's split into a global config and modular presets.

• Global Config: Located at ~/.config/lilac/lilac.toml

source-dir = "~/.local/share/lilac"

[filters]
exclude = [".DS_Store", ".git", "*.backup", "node_modules"]

• Presets: Located at ~/.config/lilac/presets/*.toml

# presets/code.toml
name = "Visual Studio Code"
aliases = ["vscode"]

[paths]
macOS = "~/Library/Application Support/Code/User"
linux = "~/.config/Code/User"

[filters]
include = [
    "settings.json",
    "keybindings.json",
    "snippets/**",
]
exclude = [
    "**/globalStorage",
    "**/workspaceStorage",
]

• https://www.hackingwithswift.com/guide/ios-swiftui/5/2/key-points
• https://developer.apple.com/documentation/xcode/running-code-on-a-specific-version

This repository is a prototype developed for an academic project.

All rights reserved.

No permission is granted to use, copy, modify, or distribute this source code, in whole or in part, without explicit prior written consent.

This repository is provided for viewing and educational purposes only. It is not intended for production use.