1When we launched D2 to open-source 2 weeks ago, we left the sprint after it a completely
2blank slate. Because, while we do have long-term goals, we wanted to make the first
3post-launch update focused 100% on addressing the biggest pain points that came up. Thank
4you so much to everyone who asked for or complained about something. Every item in this
5release was something that was posted on the D2 Discord, a GitHub issue/discussion, a
6comment on social media, or an email.
7
8On top of the listed changes to core D2, we have been building out integrations, starting
9with [Obsidian](https://github.com/terrastruct/d2-obsidian). Work has also begun on the
10API and Playground.
11
12If you want a fast way to check out what a change looks like, we put screenshots in the
13PRs when it's a visual change.
14
15#### Features 🚀
16
17- Windows support has landed! See [./docs/INSTALL.md](./docs/INSTALL.md#windows) for usage instructions. [#96](https://github.com/terrastruct/d2/issues/96)
18
19<img width="1680" alt="Screenshot 2022-12-06 at 2 55 27 AM" src="https://user-images.githubusercontent.com/10180857/205892927-6f3e116c-1c4a-440a-9972-82c306aa9779.png">
20
21- Sequence diagrams are now supported, experimentally. See [docs](https://d2lang.com/tour/sequence-diagrams). [#99](https://github.com/terrastruct/d2/issues/99)
22- Formatting of d2 scripts is supported on the CLI with the `fmt` subcommand. See `man d2` or `d2 --help`. [#292](https://github.com/terrastruct/d2/pull/292)
23- LaTeX is now supported. See [docs](https://d2lang.com/tour/text) for how to use. [#229](https://github.com/terrastruct/d2/pull/229)
24- `direction` keyword is now supported to specify `up`, `down`, `right`, `left` layouts. See [docs](https://d2lang.com/tour/layouts) for more.
25 [#251](https://github.com/terrastruct/d2/pull/251)
26- Self-referencing connections are now valid. E.g. `x -> x`. Render will vary based on layout engine. [#273](https://github.com/terrastruct/d2/pull/273)
27- Arrowhead labels are now supported. [#182](https://github.com/terrastruct/d2/pull/182)
28- Support for `stroke-dash` on shapes. [#188](https://github.com/terrastruct/d2/issues/188)
29- Support for `font-color` on shapes and connections. [#215](https://github.com/terrastruct/d2/pull/215)
30- Support for `font-size` on shapes and connections. [#250](https://github.com/terrastruct/d2/pull/250)
31- HTML IDs are now added in the SVG output. You can use this to query shapes and connections by ID post-render. [#218](https://github.com/terrastruct/d2/pull/218)
32- `-b/--bundle` flag to `d2` bundles all image assets directly as base64 data urls. [#278](https://github.com/terrastruct/d2/pull/278)
33- [install.sh](./install.sh) now accepts `-d` as an alias for `--dry-run`. [#266](https://github.com/terrastruct/d2/pull/266)
34
35#### Improvements 🧹
36
37- Local images can now be used for values to the `icon` keyword, e.g. `icon: ./my_img.png`. [#146](https://github.com/terrastruct/d2/issues/146)
38- Connection labels no longer overlap other connections. [#332](https://github.com/terrastruct/d2/pull/332)
39- ELK layout engine now defaults to top-down to be consistent with dagre. [#251](https://github.com/terrastruct/d2/pull/251)
40- Container default font styling is no longer bold. Everything used to look too bold. [#358](https://github.com/terrastruct/d2/pull/358)
41- `BROWSER=0` will disable opening a browser on `--watch`. [#311](https://github.com/terrastruct/d2/pull/311)
42- [install.sh](./install.sh) prints the dry run message more visibly. [#266](https://github.com/terrastruct/d2/pull/266)
43- `d2` now lives in the root folder of the repository instead of as a subcommand. So you can now run `go install oss.terrastruct.com/d2@latest` to install from source. [#290](https://github.com/terrastruct/d2/pull/290)
44- `install.sh` defaults to installation to `/usr/local` as before but now if `/usr/local` is not accessible to the current user, it will use `~/.local` instead of prompting for sudo. You can pass `--prefix /usr/local` to force installation into `/usr/local` with a prompt for sudo. [#372](https://github.com/terrastruct/d2/pull/372)
45
46#### Bugfixes ⛑️
47
48- 3D style was missing border and other styles for its top and right faces. [#187](https://github.com/terrastruct/d2/pull/187)
49- System dark mode was incorrectly applying to Markdown in renders. [#159](https://github.com/terrastruct/d2/issues/159)
50- Fixes Markdown newlines created with a trailing double space or backslash. [#214](https://github.com/terrastruct/d2/pull/214)
51- Fixes images not loading in PNG exports. [#224](https://github.com/terrastruct/d2/pull/224)
52- Fixes label and icon overlapping each other in dagre and ELK layouts. [#343](https://github.com/terrastruct/d2/pull/343)
53- No longer log benign file-watching errors. [#293](https://github.com/terrastruct/d2/pull/293)
54- `$BROWSER` now works to open a custom browser correctly. For example, to open Firefox on macOS: `BROWSER='open -a Firefox'` [#311](https://github.com/terrastruct/d2/pull/311)
55- Fixes numbered IDs being wrongly positioned in `dagre` [#321](https://github.com/terrastruct/d2/issues/321).
View as plain text