# `mix surface.convert`
[🔗](https://github.com/surface-ui/surface/blob/v0.12.3/lib/mix/tasks/surface/surface.convert.ex#L1)

Converts .sface files and ~F sigils from v0.7 to v0.8 syntax.

    mix surface.convert "lib/**/*.{ex,exs,sface}" "test/**/*.{ex,exs}"

Please read the [Migration Guide](https://github.com/surface-ui/surface/blob/main/MIGRATING.md)
before running the converter and make sure you follow all required steps for a successful migration.

## Task-specific options

The Surface formatter accepts a couple of the same task-specific options as `mix format`.
Here are some examples of using these options:

```bash
$ mix surface.convert --dot-formatter path/to/.formatter.exs
```

You can also use the same syntax as `mix format` for specifying which files to
convert:

```bash
$ mix surface.convert path/to/file.ex "lib/**/*.{ex,exs,sface}" "test/**/*.{ex,exs}"
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*