vue-pocketbase-template

🚨Important Notes🚨

You should probably just use nuxt or vitesse instead.

This template should help get you started developing with Vue 3 PWA in Vite, with pocketbase as backend. I've setup to deploy it on fly.io but you can deploy it anywhere.

Stack

Base

• Vue 3
• Poacketbase
• Typescript

Router / State Management / Data Fetching

• Vue Router
• Pinia
• Vue Query

UI

• Headless ui
• Iconify
• Motion

CSS / Fonts

• Tailwindcss
• Inter

DX Things

• vite-plugin-pages
• vite-plugin-vue-layouts
• unplugin-auto-import
• unplugin-vue-components
• Vue Macros

Miscellaneous

• vite-plugin-pwa
• @vueuse/head
• prettier
• eslint

Project Structure

• backend: backend contains all the backend code
• backend/build: contains all the build related files. Includes Dockerfile.
• backend/cmd: contains all the files that direclty provide commands to the program. This would also include the starting point for our app.
• src: contains all the front end source code
• src/assets: contains all the assets you want bundled via vite
• src/components: contains all the vue components
• src/composables: contains all the composables for the app
• src/layouts: contains all the layouts and it's components for the app
• src/lib: contains all the module level business logic
• src/main: main entry point for the app
• src/pages: contains all the top level page components for the app
• src/stores: contains pinia stores
• src/symbols: contains symbols to use via provide/inject vue api

General Conventions

• @ is root of your frontend source code. i.e. ./src
• We use lot of plugins to provide us with nice dx while developing the app. It allows us to just focus on the core part of the app. So try to rely on them for most cases. i.e. you don't really need to import components, core apis, functions etc. It just works.

Deploying

Recommended IDE Setup

VSCode + Volar (and disable Vetur) + TypeScript Vue Plugin (Volar) + Go

Type Support for .vue Imports in TS

TypeScript cannot handle type information for .vue imports by default, so we replace the tsc CLI with vue-tsc for type checking. In editors, we need TypeScript Vue Plugin (Volar) to make the TypeScript language service aware of .vue types.

If the standalone TypeScript plugin doesn't feel fast enough to you, Volar has also implemented a Take Over Mode that is more performant. You can enable it by the following steps:

1. Disable the built-in TypeScript Extension
   1. Run Extensions: Show Built-in Extensions from VSCode's command palette
   2. Find TypeScript and JavaScript Language Features, right click and select Disable (Workspace)
2. Reload the VSCode window by running Developer: Reload Window from the command palette.

Customize configuration

See Vite Configuration Reference.

Project Setup

Vue

pnpm install

Pocketbase

cd backend
go mod tidy

Note: You should also copy .env

cp .env.example .env

Compile and Hot-Reload for Development

Vue

pnpm dev

Pocketbase

cd backend
go run cmd/server/main.go serve

Note that it doesn't hot reload. yet. I'll add a makefile later

Type-Check, Compile and Minify for Production

pnpm build

Pocketbase

cd backend
go build -o server cmd/server/*.go

If you're using flyctl (Highly Recommended!)

cd backend
flyctl deploy --dockerfile build/Dockerfile

Lint with ESLint

pnpm lint