8 unmodified lines
9git clone https://sublimated.com/{space}/{folder}.git
10git clone https://sublimated.com/{space}/{folder}/{subfolder}.git
11```
12
13every folder in the tree is independently clonable with its own commit history.
13every folder in the tree is independently clonable with its own commit history. see [hierarchical versioning](hierarchical.md) for how this works.
14
15## hierarchical versioning
15## clone
16
17when you change a file, commits are created at every ancestor level.
18
19change `anton/blog/archive/post.md`:
201. commit at `archive/`
212. commit at `blog/`
223. commit at `anton/` (space root)
23
24all atomic. each level has a self-contained git history with only the files under that path.
25
26## clone at any level
27
17```bash
18git clone https://sublimated.com/anton.git              # whole space
19git clone https://sublimated.com/anton/blog.git          # just blog + children
20git clone https://sublimated.com/anton/blog/archive.git  # just archive
21```
22
34each clone gets only files and commits relevant to that subtree. no sparse-checkout needed.
23each clone gets only files and commits relevant to that subtree. no sparse-checkout needed — real commits exist at every level.
24
36## auth
25## push
26
38use your API token as git credentials:
39
40```bash
41# in the URL
42git clone https://token:sk_abc123@sublimated.com/anton/notes.git
43
44# or when prompted
45Username: token
46Password: sk_abc123
47```
48
49## creating folders
50
27push to a path that doesn't exist yet — sublimated creates it automatically.
28
29```bash
30mkdir my-project && cd my-project
5 unmodified lines
36```
37
38pushed [markdown](../markdown/) files render automatically when browsed on the web.
39
64## branches
40## auth
41
66branches are scoped to the folder level where they're created.
42use your API token as git credentials:
43
68create branch `draft` on `anton/blog/archive`:
69- visible when you clone `anton/blog/archive`
70- not visible when you clone `anton/blog`
71
72when you merge a scoped branch, the changes cascade up to the space root on the default branch.
73
74## tags
75
44```bash
77git tag v1.0
78git push origin v1.0
45# in the URL
46git clone https://token:sk_abc123@sublimated.com/anton/notes.git
47
48# or when prompted
49Username: token
50Password: sk_abc123
51```
52
81lightweight and annotated tags both work. tags are immutable — updating requires `--force`.
82
53## works with everything
54
55because it's standard git, your existing tools work:
56- any git GUI (Tower, Fork, GitKraken, etc)
57- CI/CD pipelines
58- `git log`, `git diff`, `git blame`, `git bisect`
59- VS Code, JetBrains, Xcode — anything that speaks git
60- [Obsidian](../markdown/obsidian.md) vaults, [iA Writer](../markdown/ia-writer.md) libraries — push and browse on the web
61
62## more
63
64- [hierarchical versioning](hierarchical.md) — how cascade commits work, clone any folder, what this enables
65- [branches and tags](branches.md) — folder-scoped branches, merging, tags