Home About Me

Valaxy: A Static Blog Framework That's Absurdly Fast

I'd had my eye on Valaxy, the static blog framework by Yun Youjun, for quite a while, but circumstances kept me on Hexo. Then I got a computer through my online classes and figured, why not migrate the blog to Valaxy? So I opened the docs and started tinkering. After a bit of setup, it was essentially ready for production use.

What really stood out was how fast it runs and its native hot reloading. That's why I want to share it here.

Getting Started

⚡️ Vue 3, Vite 2, pnpm, ESBuild - born with fastness

Local Setup

Create a new folder, open a terminal inside it, and run:

npm init valaxy
# `pnpm create valaxy` is recommended by the author

Just follow the prompts to finish initializing the project. It uses the Yun theme by default, but you can also pick the docs theme (theme-press).

Once you're inside the generated project folder, install dependencies and start the local preview:

npm install
# yarn
npm run dev
# yarn dev

After the local preview starts, visit http://localhost:4859 to see it in action. From there, edit valaxy.config.ts to customize your blog.

Automatic Deployment

You can use GitHub Pages, Netlify, Vercel, or Cloudflare Pages.

A .github/workflows/gh-pages.yml file will deploy to GitHub Pages automatically. For other platforms, check the documentation.

Manual Deployment

Run the following command to generate static files, then deploy the contents of the dist folder to your own server:

npm run build
# npm run build:spa for SPA

A Few Things to Keep in Mind

Valaxy is still in early development. The Yun theme has only replicated the main features of the Hexo version so far. You can support Valaxy's development by reporting bugs or donating to Yun Youjun.

~~Using it now basically makes you an elite beta tester~~