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 CHANGED
@@ -1,42 +1,37 @@
1
1
  # Vault CMS
2
2
 
3
- Use [Obsidian](https://obsidian.md) as a content management system for your [Astro](https://astro.build) website.
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
  ![Vault CMS cover with Obsidian and Astro logos at the bottom.](https://github.com/user-attachments/assets/fb5d8368-71dd-4bf8-8851-36ada6d4f530)
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
- ## Documentation
25
+ ### Manual Installation
18
26
 
19
- For full installation guides, plugin details, and customization options, read the [Vault CMS documentation](https://docs.vaultcms.org).
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
- ## Features
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
- - Easy integration into Astro website projects
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
- ![Vault CMS Showcase.](https://github.com/user-attachments/assets/0d1ea89e-9d6b-40b1-944d-cfe6143e222e)
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
+ ![Vault CMS Showcase.](https://github.com/user-attachments/assets/0d1ea89e-9d6b-40b1-944d-cfe6143e222e)
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.8",
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', 'README.md'];
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);