create-vault-cms 1.0.8 → 1.0.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +29 -23
- package/_GUIDE.md +26 -0
- package/package.json +2 -1
- package/src/cli.js +1 -1
package/README.md
CHANGED
|
@@ -1,42 +1,37 @@
|
|
|
1
1
|
# Vault CMS
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
The open-source headless content management system that turns [Obsidian](https://obsidian.md) into a publishing platform for your [Astro](https://astro.build) website.
|
|
4
4
|
|
|
5
5
|

|
|
6
6
|
|
|
7
|
+
## Features
|
|
8
|
+
|
|
9
|
+
- **Auto-detection and automation**: Understands your content structure and lets you focus on writing.
|
|
10
|
+
- **CMS-like homepage**: See your content in a visual grid and perform bulk actions.
|
|
11
|
+
- **Preconfigured**: Optimized settings, hotkeys, and plugins for the Astro workflow.
|
|
12
|
+
- **Headless and flexible**: Just Markdown files and a workspace ready to be customized by you.
|
|
13
|
+
- **Compatability**: Works with almost any Astro theme.
|
|
14
|
+
|
|
7
15
|
## Quick Start
|
|
8
16
|
|
|
9
|
-
The fastest way to install Vault CMS into your Astro project is via the CLI:
|
|
17
|
+
The fastest way to install Vault CMS into your Astro project is via the CLI at your project root:
|
|
10
18
|
|
|
11
19
|
```bash
|
|
12
20
|
pnpm create vault-cms
|
|
13
21
|
```
|
|
14
22
|
|
|
15
|
-
*Follow the prompts to install into `src/content` or your desired directory.*
|
|
23
|
+
*Follow the prompts to install into `src/content` or your desired sub-directory.*
|
|
16
24
|
|
|
17
|
-
|
|
25
|
+
### Manual Installation
|
|
18
26
|
|
|
19
|
-
|
|
27
|
+
If you prefer to install manually, you can download the latest version of Vault CMS and place it directly into your Astro project.
|
|
20
28
|
|
|
21
|
-
|
|
29
|
+
1. **Download the source**: [Clone this repository](https://github.com/davidvkimball/vault-cms) or [download the ZIP archive](https://github.com/davidvkimball/vault-cms/archive/refs/heads/master.zip).
|
|
30
|
+
2. **Locate your content directory**: In most Astro projects, this is `src/content`.
|
|
31
|
+
3. **Move the files**: Copy the `.obsidian` and `_bases` folders (and `_GUIDE.md`) from the Vault CMS source into your content directory.
|
|
32
|
+
4. **Open in Obsidian**: Open the content directory as a new vault in Obsidian.
|
|
22
33
|
|
|
23
|
-
|
|
24
|
-
- **Auto-detection** of your Astro theme and content structure
|
|
25
|
-
- Preconfigured plugins, hotkeys and settings optimized for Astro workflows
|
|
26
|
-
- CMS-like homepage using Obsidian Bases
|
|
27
|
-
- Works with any Astro theme by automatically detecting content types and frontmatter properties
|
|
28
|
-
- Optional instant-publish option via the Git plugin
|
|
29
|
-
|
|
30
|
-

|
|
31
|
-
|
|
32
|
-
## Video Guide
|
|
33
|
-
|
|
34
|
-
📺 [Video Guide](https://youtu.be/dSm8aLPdVz0)
|
|
35
|
-
|
|
36
|
-
> [!NOTE]
|
|
37
|
-
> To see Vault CMS combined with an Astro site specifically designed with it in mind, check out my theme [Astro Modular](https://github.com/davidvkimball/astro-modular).
|
|
38
|
-
|
|
39
|
-
## Presets
|
|
34
|
+
### Presets
|
|
40
35
|
|
|
41
36
|
If you are using a supported theme like **Starlight**, **Slate**, or **Chiri**, you can use a preconfigured preset:
|
|
42
37
|
|
|
@@ -45,3 +40,14 @@ pnpm create vault-cms -- --template starlight
|
|
|
45
40
|
```
|
|
46
41
|
|
|
47
42
|
See all available presets at the [Presets Repo](https://github.com/davidvkimball/vault-cms-presets).
|
|
43
|
+
|
|
44
|
+
## Deep Dive
|
|
45
|
+
|
|
46
|
+
- **Documentation**: [docs.vaultcms.org](https://docs.vaultcms.org)
|
|
47
|
+
- **Video Guide**: [Set Up Guide on YouTube](https://www.youtube.com/watch?v=3zeqJ5tqmaQ)
|
|
48
|
+
- **Community**: [Join the Discord](https://discord.gg/gyrNHAwHK8)
|
|
49
|
+
|
|
50
|
+
> [!NOTE]
|
|
51
|
+
> To see Vault CMS combined with an Astro site specifically designed with it in mind, check out the [Astro Modular](https://github.com/davidvkimball/astro-modular) theme.
|
|
52
|
+
|
|
53
|
+

|
package/_GUIDE.md
ADDED
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Welcome to Vault CMS
|
|
2
|
+
|
|
3
|
+
## Run the setup wizard
|
|
4
|
+
|
|
5
|
+
If you just installed Vault CMS, the most important step is running the wizard. It will detect your Astro theme and configure your content types automatically.
|
|
6
|
+
|
|
7
|
+
> [!TIP]
|
|
8
|
+
> **Command**: Press `Ctrl/Cmd + P` and search for **"Vault CMS: Open Wizard"** if you closed it.
|
|
9
|
+
|
|
10
|
+
## The CMS home base
|
|
11
|
+
|
|
12
|
+
We use a custom Obsidian bases view to give you a bird's-eye view of your content.
|
|
13
|
+
|
|
14
|
+
> [!NOTE]
|
|
15
|
+
> Click the **Home** icon in your tab bar or open the `_bases/Home.base` file to see your content in a grid view.
|
|
16
|
+
|
|
17
|
+
## Key workflows
|
|
18
|
+
|
|
19
|
+
- **Writing**: hust use `Ctrl/Cmd + N` to create a new file using your default content type and start writing.
|
|
20
|
+
- **Publishing**: use the **Git: Push** command (or click the up arrow in the status bar) to send your changes live to your Astro site.
|
|
21
|
+
|
|
22
|
+
### Need help?
|
|
23
|
+
|
|
24
|
+
- **Documentation**: [docs.vaultcms.org](https://docs.vaultcms.org)
|
|
25
|
+
- **Community**: [join the Discord](https://discord.gg/gyrNHAwHK8)
|
|
26
|
+
- **Video Guide**: [set up guide on YouTube](https://www.youtube.com/watch?v=3zeqJ5tqmaQ)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "create-vault-cms",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.9",
|
|
4
4
|
"description": "Installer for Vault CMS",
|
|
5
5
|
"main": "src/cli.js",
|
|
6
6
|
"bin": {
|
|
@@ -9,6 +9,7 @@
|
|
|
9
9
|
"files": [
|
|
10
10
|
"src",
|
|
11
11
|
"README.md",
|
|
12
|
+
"_GUIDE.md",
|
|
12
13
|
"LICENSE"
|
|
13
14
|
],
|
|
14
15
|
"scripts": {
|
package/src/cli.js
CHANGED
|
@@ -97,7 +97,7 @@ program
|
|
|
97
97
|
throw new Error(`Template "${template}" not found in presets repository.`);
|
|
98
98
|
}
|
|
99
99
|
|
|
100
|
-
const toKeep = ['_bases', '.obsidian', '
|
|
100
|
+
const toKeep = ['_bases', '.obsidian', '_GUIDE.md'];
|
|
101
101
|
for (const item of toKeep) {
|
|
102
102
|
const src = path.join(sourcePath, item);
|
|
103
103
|
const dest = path.join(targetDir, item);
|