https://github.com/bistroo/vue-ssr
Minimalistic wrapper to develop and run SSR Vue apps 🔗
https://github.com/bistroo/vue-ssr
hmr-support ssr vite vue
Last synced: 8 days ago
JSON representation
Minimalistic wrapper to develop and run SSR Vue apps 🔗
- Host: GitHub
- URL: https://github.com/bistroo/vue-ssr
- Owner: bistroo
- License: mit
- Archived: true
- Created: 2023-05-02T07:32:14.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-27T12:02:53.000Z (about 1 year ago)
- Last Synced: 2025-03-17T05:47:05.916Z (about 1 month ago)
- Topics: hmr-support, ssr, vite, vue
- Language: TypeScript
- Homepage:
- Size: 104 KB
- Stars: 12
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-awesome-vite - vue-ssr - Minimalistic wrapper to develop and run SSR powered Vue apps. ![vue3] (SSR / Libraries)
- awesome-vite - vue-ssr - Minimalistic wrapper to develop and run SSR powered Vue apps. ![vue3] (SSR / Libraries)
README
# SSR for Vue
Minimalistic wrapper to run SSR Vue apps, based on Vite
## Features
* HMR support
* Vue Router
* State management
* Teleports
* Document head management (powered by [@vueuse/head](https://github.com/vueuse/head))
## Quick Setup
### Installation
```sh
pnpm install @bistroo/vue-ssr -D
```
Add the following scripts
```json
"scripts": {
"dev": "vue-ssr",
"build": "vue-ssr build",
"start": "vue-ssr start"
},
```
> The `vue-ssr` command creates a dev server with HMR enabled.
To create a production ready build, use `vue-ssr build`. After creating a build, use `vue-ssr start` to serve the build with Express.
### Configuration
Create a vue-ssr.config.ts
```typescript
import { defineConfig } from '@bistroo/vue-ssr'
import { fileURLToPath } from 'node:url'
export default defineConfig({
vite: {
resolve: {
alias: {
'@': fileURLToPath(new URL('./src', import.meta.url)),
},
},
},
})
```
> Use the `vite` property with caution.
### Usage
```ts
import { vueSSR } from '@bistroo/vue-ssr'
import App from '@/App.vue'
const Counter = () => import('@/Counter.vue')
const routes = [
{
path: '/',
name: 'counter',
component: Counter,
}
]
export default vueSSR(App, { routes })
```
The `main.ts` file should export the imported vueSSR function.
Pinia is supported by using the `app` and `state` property inside the callback.
```typescript
export default vueSSR(App, { routes }, ({ app, state }) => {
const pinia = createPinia()
app.use(pinia)
if (import.meta.env.SSR) {
state.value = pinia.state.value
} else {
pinia.state.value = state.value
}
})
```
> The state will be persisted on `window.__INITIAL_STATE__` property and serialized using `@nuxt/devalue`
It's possible to make changes to the router, use the `router` property in the callback.
```typescript
export default vueSSR(App, { routes }, ({ router }) => {
router.beforeEach(async (to, from) => {
if (
!isAuthenticated &&
to.name !== 'Login'
) {
return { name: 'Login' }
}
})
})
```
The Express request and response objects are accessible from the callback. Make sure to wrap them in `import.meta.env.SSR`.
```typescript
export default vueSSR(App, { routes }, ({ request, response }) => {
if (import.meta.env.SSR) {
console.log(request?.originalUrl)
}
})
```
Or use `useSSRContext`.
```typescript
const { request, response } = useSSRContext()
if (import.meta.env.SSR) {
console.log(request?.originalUrl)
}
```
Using Teleport is supported, but requires a little bit of setup. Targeting `body` is not supported, use `#teleports` instead.
```html
Increment
```
During SSR, the Teleport component will be rendered as a `div` with the `id` set to the `to` property.
## License
MIT