2026-05-07 07:29:50 +00:00
<!DOCTYPE html>
< html lang = "en-US" dir = "ltr" >
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width,initial-scale=1" >
< title > File Layout | Tolaria< / title >
< meta name = "description" content = "Tolaria is a local-first Markdown knowledge base with native relationships, Git history, and AI workflows." >
< meta name = "generator" content = "VitePress v1.6.4" >
2026-05-07 12:13:19 +00:00
< link rel = "preload stylesheet" href = "/tolaria/assets/style.DeVPLYtG.css" as = "style" >
2026-05-07 07:29:50 +00:00
< link rel = "preload stylesheet" href = "/tolaria/vp-icons.css" as = "style" >
2026-05-07 13:03:17 +00:00
< script type = "module" src = "/tolaria/assets/app.D3snHqQg.js" > < / script >
2026-05-07 07:29:50 +00:00
< link rel = "preload" href = "/tolaria/assets/inter-roman-latin.Di8DUHzh.woff2" as = "font" type = "font/woff2" crossorigin = "" >
2026-05-07 13:03:17 +00:00
< link rel = "modulepreload" href = "/tolaria/assets/chunks/theme.RsTuzNU8.js" >
2026-05-07 07:29:50 +00:00
< link rel = "modulepreload" href = "/tolaria/assets/chunks/framework.B8zgMDLd.js" >
< link rel = "modulepreload" href = "/tolaria/assets/reference_file-layout.md.DMB3wGMi.lean.js" >
< link rel = "icon" type = "image/png" href = "/tolaria/landing/favicon.png" >
< meta property = "og:title" content = "Tolaria" >
< meta property = "og:description" content = "A second brain for the AI era. Free forever, local-first, Markdown-based, Git-ready, and AI-friendly." >
< script id = "check-dark-mode" > ( ( ) => { const e = localStorage . getItem ( "vitepress-theme-appearance" ) || "auto" , a = window . matchMedia ( "(prefers-color-scheme: dark)" ) . matches ; ( ! e || e === "auto" ? a : e === "dark" ) && document . documentElement . classList . add ( "dark" ) } ) ( ) ; < / script >
< script id = "check-mac-os" > document . documentElement . classList . toggle ( "mac" , /Mac|iPhone|iPod|iPad/i . test ( navigator . platform ) ) ; < / script >
< / head >
< body >
2026-05-07 12:13:19 +00:00
< div id = "app" > < div class = "" data-v-0418e6e1 > < div class = "Layout" data-v-0418e6e1 data-v-ccf76b0c > <!-- [ --> <!-- ] --> <!-- [ --> < span tabindex = "-1" data-v-3cf742b9 > < / span > < a href = "#VPContent" class = "VPSkipLink visually-hidden" data-v-3cf742b9 > Skip to content< / a > <!-- ] --> <!-- --> < header class = "VPNav" data-v-ccf76b0c data-v-e1256463 > < div class = "VPNavBar" data-v-e1256463 data-v-c0d22204 > < div class = "wrapper" data-v-c0d22204 > < div class = "container" data-v-c0d22204 > < div class = "title" data-v-c0d22204 > < div class = "VPNavBarTitle has-sidebar" data-v-c0d22204 data-v-ca0cf389 > < a class = "title" href = "/tolaria/" data-v-ca0cf389 > <!-- [ --> <!-- ] --> <!-- [ --> < img class = "VPImage logo" src = "/tolaria/landing/tolaria-icon.png" alt = "Tolaria" data-v-deda50b0 > <!-- ] --> < span data-v-ca0cf389 > Tolaria< / span > <!-- [ --> <!-- ] --> < / a > < / div > < / div > < div class = "content" data-v-c0d22204 > < div class = "content-body" data-v-c0d22204 > <!-- [ --> <!-- ] --> < div class = "VPNavBarSearch search" data-v-c0d22204 > <!-- [ --> <!-- --> < div id = "local-search" > < button type = "button" class = "DocSearch DocSearch-Button" aria-label = "Search" > < span class = "DocSearch-Button-Container" > < span class = "vp-icon DocSearch-Search-Icon" > < / span > < span class = "DocSearch-Button-Placeholder" > Search< / span > < / span > < span class = "DocSearch-Button-Keys" > < kbd class = "DocSearch-Button-Key" > < / kbd > < kbd class = "DocSearch-Button-Key" > K< / kbd > < / span > < / button > < / div > <!-- ] --> < / div > < nav aria-labelledby = "main-nav-aria-label" class = "VPNavBarMenu menu" data-v-c0d22204 data-v-5594a541 > < span id = "main-nav-aria-label" class = "visually-hidden" data-v-5594a541 > Main Navigation < / span > <!-- [ --> <!-- [ --> < a class = "VPLink link VPNavBarMenuLink" href = "/tolaria/start/install" tabindex = "0" data-v-5594a541 data-v-75347875 > <!-- [ --> < span data-v-75347875 > Start< / span > <!-- ] --> < / a > <!-- ] --> <!-- [ --> < a class = "VPLink link VPNavBarMenuLink" href = "/tolaria/concepts/vaults" tabindex = "0" data-v-5594a541 data-v-75347875 > <!-- [ --> < span data-v-75347875 > Concepts< / span > <!-- ] --> < / a > <!-- ] --> <!-- [ --> < a class = "VPLink link VPNavBarMenuLink" href = "/tolaria/guides/capture-a-note" tabindex = "0" data-v-5594a541 data-v-75347875 > <!-- [ --> < span data-v-75347875 > Guides< / span > <!-- ] --> < / a > <!-- ] --> <!-- [ --> < a class = "VPLink link vp-external-link-icon no-icon VPNavBarMenuLink" href = "https://tolaria.md/download/" target = "_self" rel = "noreferrer" tabindex = "0" data-v-5594a541 data-v-75347875 > <!-- [ --> < span data-v-75347875 > Downloads< / span > <!-- ] --> < / a > <!-- ] --> <!-- ] --> < / nav > <!-- --> < div class = "VPNavBarAppearance appearance" data-v-c0d22204 data-v-cbc799be > < button class = "VPSwitch VPSwitchAppearance" type = "button" role = "switch" title aria-checked = "false" data-v-cbc799be data-v-177cfd24 data-v-7f73ba5a > < span class = "check" data-v-7f73ba5a > < span class = "icon" data-v-7f73ba5a > <!-- [ --> < span class = "vpi-sun sun" data-v-177cfd24 > < / span > < span class = "vpi-moon moon" data-v-177cfd24 > < / span > <!-- ] --> < / span > < / span > < / button > < / div > <!-- --> < div class = "VPFlyout VPNavBarExtra extra" data-v-c0d22204 data-v-6da53269 data-v-b8c36a12 > < button type = "button" class = "button" aria-haspopup = "true" aria-expanded = "false" aria-label = "extra navigation" data-v-b8c36a12 > < span class = "vpi-more-horizontal icon" data-v-b8c36a12 > < / span > < / button > < div class = "menu" data-v-b8c36a12 > < div class = "VPMenu" data-v-b8c36a12 data-v-a8c21b34 > <!-- --> <!-- [ --> <!-- [ --> <!-- --> < div class = "group" data-v-6da53269 > < div class = "item appearance" data-v-6da53269 > < p class = "label" data-v-6da53269 > Appearance< / p > < div class = "appearance-action" data-v-6da53269 > < button class = "VPSwitch VPSwitchAppearance" type = "button" role = "switch" title aria-checked = "false" data-v-6da53269 data-v-177cfd24 data-v-7f73ba5a > < span class = "check" data-v-7f73ba5a > < span class = "icon" data-v-7f73ba5a > <!-- [ --> < span class = "vpi-sun sun" data-v-177cfd24 > < / span > < span class = "vpi-moon moon" data-v-177cfd24 > < / span > <!-- ] --> < / span > < / span > < / button > < / div > < / div > < / div > <!-- --> <!-- ] --> <!-- ] --> < / div > < / div > < / div > <!-- [ --> <!-- [ --> <!-- [ --> < a class = "github-star-widget" href = "https://github.com/refactoringhq/tolaria" target = "_blank" rel = "noreferrer" aria-label = "9,946 GitHub stars" data-v-0418e6e1 > < svg viewBox = "0 0 24 24" aria-hidden = "true" d
2026-05-07 07:29:50 +00:00
< span class = "line" > < span > project-alpha.md< / span > < / span >
< span class = "line" > < span > weekly-review.md< / span > < / span >
< span class = "line" > < span > research/< / span > < / span >
< span class = "line" > < span > source-notes.md< / span > < / span >
< span class = "line" > < span > attachments/< / span > < / span >
< span class = "line" > < span > diagram.png< / span > < / span >
< span class = "line" > < span > source.pdf< / span > < / span >
< span class = "line" > < span > project.md< / span > < / span >
< span class = "line" > < span > person.md< / span > < / span >
< span class = "line" > < span > views/< / span > < / span >
< span class = "line" > < span > active-projects.yml< / span > < / span > < / code > < / pre > < / div > < h2 id = "root-notes" tabindex = "-1" > Root Notes < a class = "header-anchor" href = "#root-notes" aria-label = "Permalink to "Root Notes"" > < / a > < / h2 > < p > Tolaria works well with a flat vault. Folders are optional and can be useful for compatibility with other tools, but they are not required for people, projects, topics, or any other note category.< / p > < p > Type is not inferred from folder location. It comes from frontmatter, and relationships are expressed with wikilinks in fields. That is what Tolaria uses for the sidebar, Properties panel, search, custom views, and neighborhood navigation.< / p > < h2 id = "special-folders" tabindex = "-1" > Special Folders < a class = "header-anchor" href = "#special-folders" aria-label = "Permalink to "Special Folders"" > < / a > < / h2 > < table tabindex = "0" > < thead > < tr > < th > Folder< / th > < th > Purpose< / th > < / tr > < / thead > < tbody > < tr > < td > < code > views/< / code > < / td > < td > Saved custom views.< / td > < / tr > < tr > < td > < code > attachments/< / code > < / td > < td > Images and other attached files.< / td > < / tr > < / tbody > < / table > < p > PDFs, images, and other non-Markdown files stay as normal files. Folder browsing can show them in place, and Settings controls whether PDFs, images, and unsupported files appear in All Notes.< / p > < p > Whiteboards are Markdown files with durable tldraw data, so they belong with notes rather than in < code > attachments/< / code > .< / p > < p > Type definitions are Markdown notes with < code > type: Type< / code > in frontmatter. New type documents are normal notes, and existing type documents in older folders still work.< / p > < h2 id = "git-files" tabindex = "-1" > Git Files < a class = "header-anchor" href = "#git-files" aria-label = "Permalink to "Git Files"" > < / a > < / h2 > < p > If the vault is a Git repository, < code > .git/< / code > belongs to Git. Tolaria reads Git state but does not treat < code > .git/< / code > as notes.< / p > < / div > < / div > < / main > < footer class = "VPDocFooter" data-v-478bd20d data-v-f76ba9a2 > <!-- [ --> <!-- ] --> <!-- --> < nav class = "prev-next" aria-labelledby = "doc-footer-aria-label" data-v-f76ba9a2 > < span class = "visually-hidden" id = "doc-footer-aria-label" data-v-f76ba9a2 > Pager< / span > < div class = "pager" data-v-f76ba9a2 > < a class = "VPLink link pager-link prev" href = "/tolaria/reference/supported-platforms" data-v-f76ba9a2 > <!-- [ --> < span class = "desc" data-v-f76ba9a2 > Previous page< / span > < span class = "title" data-v-f76ba9a2 > Supported Platforms< / span > <!-- ] --> < / a > < / div > < div class = "pager" data-v-f76ba9a2 > < a class = "VPLink link pager-link next" href = "/tolaria/reference/frontmatter-fields" data-v-f76ba9a2 > <!-- [ --> < span class = "desc" data-v-f76ba9a2 > Next page< / span > < span class = "title" data-v-f76ba9a2 > Frontmatter Fields< / span > <!-- ] --> < / a > < / div > < / nav > < / footer > <!-- [ --> <!-- ] --> < / div > < / div > < / div > <!-- [ --> <!-- ] --> < / div > < / div > < footer class = "VPFooter has-sidebar" data-v-ccf76b0c data-v-d4c9b439 > < div class = "container" data-v-d4c9b439 > < p class = "message" data-v-d4c9b439 > Free and open source. Local-first, Git-first, and Markdown-based.< / p > < p class = "copyright" data-v-d4c9b439 > Tolaria is AGPL-3.0-or-later. The Tolaria name and logo remain covered by the project trademark policy.< / p > < / div > < / footer > <!-- [ --> <!-- ] --> < / div > < / div > < / div >
2026-05-07 12:13:19 +00:00
< script > w i n d o w . _ _ V P _ H A S H _ M A P _ _ = J S O N . p a r s e ( " { \ " c o n c e p t s _ a i . m d \ " : \ " D I K 5 B f g 0 \ " , \ " c o n c e p t s _ e d i t o r . m d \ " : \ " D D U R 8 n 9 t \ " , \ " c o n c e p t s _ f i l e s - a n d - m e d i a . m d \ " : \ " j X 8 0 S L T G \ " , \ " c o n c e p t s _ g i t . m d \ " : \ " B A d h _ m g D \ " , \ " c o n c e p t s _ i n b o x . m d \ " : \ " C z C P s t D V \ " , \ " c o n c e p t s _ n o t e s . m d \ " : \ " D X 6 C E n Z w \ " , \ " c o n c e p t s _ p r o p e r t i e s . m d \ " : \ " B T p _ D H w u \ " , \ " c o n c e p t s _ r e l a t i o n s h i p s . m d \ " : \ " C Z T a F K 8 t \ " , \ " c o n c e p t s _ t y p e s . m d \ " : \ " B 9 g D L 4 6 C \ " , \ " c o n c e p t s _ v a u l t s . m d \ " : \ " 7 t X S Q e t T \ " , \ " g u i d e s _ b u i l d - c u s t o m - v i e w s . m d \ " : \ " o C c w i w D P \ " , \ " g u i d e s _ c a p t u r e - a - n o t e . m d \ " : \ " C f O F L 1 p V \ " , \ " g u i d e s _ c o m m i t - a n d - p u s h . m d \ " : \ " W q B s F x V F \ " , \ " g u i d e s _ c o n f i g u r e - a i - m o d e l s . m d \ " : \ " o q s 2 L K 2 1 \ " , \ " g u i d e s _ c o n n e c t - a - g i t - r e m o t e . m d \ " : \ " B T 1 n d 6 k x \ " , \ " g u i d e s _ c r e a t e - t y p e s . m d \ " : \ " B j g k I A t x \ " , \ " g u i d e s _ m a n a g e - d i s p l a y - p r e f e r e n c e s . m d \ " : \ " C m l h d e - y \ " , \ " g u i d e s _ o r g a n i z e - i n b o x . m d \ " : \ " C L K j B s 0 A \ " , \ " g u i d e s _ u s e - a i - p a n e l . m d \ " : \ " C C G F 9 Z 7 7 \ " , \ " g u i d e s _ u s e - c o m m a n d - p a l e t t e . m d \ " : \ " D _ 4 Y 1 c p H \ " , \ " g u i d e s _ u s e - m e d i a - p r e v i e w s . m d \ " : \ " D q t j k X G v \ " , \ " g u i d e s _ u s e - t a b l e - o f - c o n t e n t s . m d \ " : \ " D L x D C H l k \ " , \ " g u i d e s _ u s e - w i k i l i n k s . m d \ " : \ " B q v - M g H a \ " , \ " i n d e x . m d \ " : \ " x M _ F 9 V 4 7 \ " , \ " r e f e r e n c e _ c o n t r i b u t e . m d \ " : \ " D D G 6 1 u a i \ " , \ " r e f e r e n c e _ d o c s - m a i n t e n a n c e . m d \ " : \ " C x W f N b S y \ " , \ " r e f e r e n c e _ f i l e - l a y o u t . m d \ " : \ " D M B 3 w G M i \ " , \ " r e f e r e n c e _ f r o n t m a t t e r - f i e l d s . m d \ " : \ " B X s 6 l t C P \ " , \ " r e f e r e n c e _ k e y b o a r d - s h o r t c u t s . m d \ " : \ " D T u 7 r S X c \ " , \ " r e f e r e n c e _ r e l e a s e - c h a n n e l s . m d \ " : \ " B H J S d q 9 n \ " , \ " r e f e r e n c e _ s u p p o r t e d - p l a t f o r m s . m d \ " : \ " r c g 1 m j B b \ " , \ " r e f e r e n c e _ v i e w - f i l t e r s . m d \ " : \ " B u q S k g h Y \ " , \ " r e l e a s e s _ i n d e x . m d \ " : \ " D 8 v M 7 F 3 s \ " , \ " s t a r t _ f i r s t - l a u n c h . m d \ " : \ " C 4 J H n 8 4 l \ " , \ " s t a r t _ g e t t i n g - s t a r t e d - v a u l t . m d \ " : \ " D K L a g f 0 T \ " , \ " s t a r t _ i n s t a l l . m d \ " : \ " J L b P S - f o \ " , \ " s t a r t _ o p e n - o r - c r e a t e - v a u l t . m d \ " : \ " y 8 p m m 3 e h \ " , \ " t r o u b l e s h o o t i n g _ a i - a g e n t - n o t - f o u n d . m d \ " : \ " C 3 M m b 3 f 1 \ " , \ " t r o u b l e s h o o t i n g _ g i t - a u t h . m d \ " : \ " C s D i 2 8 b X \ " , \ " t r o u b l e s h o o t i n g _ m o d e l - p r o v i d e r - c o n n e c t i o n . m d \ " : \ " B 3 t n y R F n \ " , \ " t r o u b l e s h o o t i n g _ s y n c - c o n f l i c t s . m d \ " : \ " D J w n C t F 5 \ " , \ " t r o u b l e s h o o t i n g _ v a u l t - n o t - l o a d i n g . m d \ " : \ " h Q z v Z m 3 Q \ " } " ) ; w i n d o w . _ _ V P _ S I T E _ D A T A _ _ = J S O N . p a r s e ( " { \ " l a n g \ " : \ " e n - U S \ " , \ " d i r \ " : \ " l t r \ " , \ " t i t l e \ " : \ " T o l a r i a \ " , \ " d e s c r i p t i o n \ " : \ " T o l a r i a i s a l o c a l - f i r s t M a r k d o w n k n o w l e d g e b a s e w i t h n a t i v e r e l a t i o n s h i p s , G i t h i s t o r y , a n d A I w o r k f l o w s . \ " , \ " b a s e \ " : \ " / t o l a r i a / \ " , \ " h e a d \ " : [ ] , \ " r o u t e r \ " : { \ " p r e f e t c h L i n k s \ " : t r u e } , \ " a p p e a r a n c e \ " : t r u e , \ " t h e m e C o n f i g \ " : { \ " l o g o \ " : { \ " s r c \ " : \ " / l a n d i n g / t o l a r i a - i c o n . p n g \ " , \ " a l t \ " : \ " T o l a r i a \ " } , \ " n a v \ " : [ { \ " t e x t \ " : \ " S t a r t \ " , \ " l i n k \ " : \ " / s t a r t / i n s t a l l \ " } , { \ " t e x t \ " : \ " C o n c e p t s \ " , \ " l i n k \ " : \ " / c o n c e p t s / v a u l t s \ " } , { \ " t e x t \ " : \ " G u i d e s \ " , \ " l i n k \ " : \ " / g u i d e s / c a p t u r e - a - n o t e \ " } , { \ " t e x t \ " : \ " D o w n l o a d s \ " , \ " l i n k \ " : \ " h t t p s : / / t o l a r i a . m d / d o w n l o a d / \ " , \ " t a r g e t \ " : \ " _ s e l f \ " , \ " n o I c o n \ " : t r u e } ] , \ " s e a r c h \ " : { \ " p r o v i d e r \ " : \ " l o c a l \ " } , \ " s i d e b a r \ " : [ { \ " t e x t \ " : \ " S t a r t H e r e \ " , \ " i t e m s \ " : [ { \ " t e x t \ " : \ " I n s t a l l T o l a r i a \ " , \ " l i n k \ " : \ " / s t a r t / i n s t a l l \ " } , { \ " t e x t \ " : \ " F i r s t L a u n c h \ " , \ " l i n k \ " : \ " / s t a r t / f i r s t - l a u n c h \ " } , { \ " t e x t \ " : \ " G e t t i n g S t a r t e d V a u l t \ " , \ " l i n k \ " : \ " / s t a r t / g e t t i n g - s t a r t e d - v a u l t \ " } , { \ " t e x t \ " : \ " O p e n O r C r e a t e A V a u l t \ " , \ " l i n k \ " : \ " / s t a r t / o p e n - o r - c r e a t e - v a u l t \ " } ] } , { \ " t e x t \ " : \ " C o n c e p t s \ " , \ " i t e m s \ " : [ { \ " t e x t \ " : \ " V a u l t s \ " , \ " l i n k \ " : \ " / c o n c e p t s / v a u l t s \ " } , { \ " t e x t \ " : \ " N o t e s \ " , \ " l i n k \ " : \ " / c o n c e p t s / n o t e s \ " } , { \ " t e x t \ " : \ " E d i t o r \ " , \ " l i n k \ " : \ " / c o n c e p t s / e d i t o r \ " } , { \ " t e x t \ " : \ " P r o p e r t i e s \ " , \ " l i n k \ " : \ " / c o n c e p t s / p r o p e r t i e s \ " } , { \ " t e x t \ " : \ " T y p e s \ " , \ " l i n k \ " : \ " / c o n c e p t s / t y p e s \ " } , { \ " t e x t \ " : \ " R e l a t i o n s h i p s \ " , \ " l i n k \ " : \ " / c o n c e p t s / r e l a t i o n s h i p s \ " } , { \ " t e x t \ " : \ " F i l e s A n d M e d i a \ " , \ " l i n k \ " : \ " / c o n c e p t s / f i l e s - a n d - m e d i a \ " } , { \ " t e x t \ " : \ " I n b o x \ " , \ " l i n k \ " : \ " / c o n c e p t s / i n b o x \ " } , { \ " t e x t \ " : \ " G i t \ " , \ " l i n k \ " : \ " / c o n c e p t s / g i t \ " } , { \ " t e x t \ " : \ " A I \ " , \ " l i n k \ " : \ " / c o n c e p t s / a i \ " } ] } , { \ " t e x t \ " : \ " G u i d e s \ " , \ " i t e m s \ " : [ { \ " t e x t \ " : \ " C a p t u r e A N o t e \ " , \ " l i n k \ " : \ " / g u i d e s / c a p t u r e - a - n o t e \ " } , { \ " t e x t \ " : \ " O r g a n i z e T h e I n b o x \ " , \ " l i n k \ " : \ " / g u i d e s / o r g a n i z e - i n b o x \ " } , { \ " t e x t \ " : \ " U s e W i k i l i n k s \ " , \ " l i n k \ " : \ " / g u i d e s / u s e - w i k i l i n k s \ " } , { \ " t e x t \ " : \ " C r e a t e T y p e s \ " , \ " l i n k \ " : \ " / g u i d e s / c r e a t e - t y p e s \ " } , { \ " t e x t \ " : \ " B u i l d C u s t o m V i e w s \ " , \ " l i n k \ " : \ " / g u i d e s / b u i l d - c u s t o m - v i e w s \ " } , { \ " t e x t \ " : \ " C o n n e c t A G i t R e m o t e \ " , \ " l i n k \ " : \ " / g u i d e s / c o n n e c t - a - g i t - r e m o t e \ " } , { \ " t e x t \ " : \ " M a n a g e G i t \ " , \ " l i n k \ " : \ " / g u i d e s / c o m m i t - a n d - p u s h \ " } , { \ " t e x t \ " : \ " U s e T h e A I \ " , \ " l i n k \ " : \ " / g u i d e s / u s e - a i - p a n e l \ " } , { \ " t e x t \ " : \ " C o n f i g u r e A I M o d e l s \ " , \ " l i n k \ "
2026-05-07 07:29:50 +00:00
< / body >
< / html >
