refactor: redesign module system

src/main.ts

@@ -1,22 +1,14 @@
 import './styles/main.postcss'
-// import routes generated by Voie
 import routes from 'vite-plugin-pages/client'
-// progress bar
-import NProgress from 'nprogress'
 import { ViteSSG } from 'vite-ssg'
-import installPlugins from './plugins'
 import App from './App.vue'
 
 // https://github.com/antfu/vite-ssg
 export const createApp = ViteSSG(
   App,
   { routes },
-  ({ app, router, isClient }) => {
+  (ctx) => {
-    installPlugins(app)
+    // install all modules under `modules/`
-
+    Object.values(import.meta.globEager('./modules/*.ts')).map(i => i.install?.(ctx))
-    if (isClient) {
-      router.beforeEach(() => { NProgress.start() })
-      router.afterEach(() => { NProgress.done() })
-    }
   },
 )

src/modules/README.md

@@ -0,0 +1,11 @@
+## Modules
+
+A custom user module system. Place a `.ts` file with the following template, it will be installed automatically.
+
+```ts
+import { UserModule } from '/~/types'
+
+export const install: UserModule = ({ app, router, isClient }) => {
+  // do something
+}
+```

src/modules/i18n.ts

@@ -1,5 +1,5 @@
-import { App } from 'vue'
 import { createI18n } from 'vue-i18n'
+import { UserModule } from '/~/types'
 
 // import i18n resources
 // https://vitejs.dev/guide/features.html#glob-import
@@ -11,7 +11,7 @@ const messages = Object.fromEntries(
     }),
 )
 
-export default (app: App) => {
+export const install: UserModule = ({ app }) => {
   const i18n = createI18n({
     legacy: false,
     locale: 'en',

src/modules/nprogress.ts

@@ -0,0 +1,9 @@
+import NProgress from 'nprogress'
+import { UserModule } from '/~/types'
+
+export const install: UserModule = ({ isClient, router }) => {
+  if (isClient) {
+    router.beforeEach(() => { NProgress.start() })
+    router.afterEach(() => { NProgress.done() })
+  }
+}

src/pages/README.md

@@ -5,7 +5,7 @@ Check out [`vite-plugin-pages`](https://github.com/hannoeru/vite-plugin-pages) f
 
 ### Path Aliasing
 
-You can use `/~/` aliasing to `./src/` folder.
+`/~/` is aliased to `./src/` folder.
 
 For example, instead of having
 

src/plugins/index.ts

@@ -1,6 +0,0 @@
-import { App } from 'vue'
-import installI18n from './i18n'
-
-export default (app: App) => {
-  installI18n(app)
-}

src/types.ts

@@ -0,0 +1,3 @@
+import { ViteSSGContext } from 'vite-ssg'
+
+export type UserModule = (ctx: ViteSSGContext) => void