DockIY Nuxt template

A flexible Nuxt starter for applications deployed with DockIY. It does not prescribe a database or authentication system.

Docs for this template

• Website
• Demo
• Codeberg

Requirements

Install Node.js 24+, pnpm 11+, Docker Engine, Docker Compose, and the DockIY CLI. Install SOPS and age if you will use encrypted environment files.

Get started

Create a project or clone this repository, then edit dockiy.yml in the project root. Set name and the staging/production hosts:

name: my-app

environments:
  staging:
    host: staging.example.com
    compose_file: docker-compose.yml
    secrets_file: .enc.staging.env
  production:
    host: example.com
    compose_file: docker-compose.yml
    secrets_file: .enc.production.env

Install dependencies and start Nuxt:

pnpm install
pnpm dev

For local values, copy .env.example to .env, or decrypt the local dotenv file:

cp .env.example .env
# or: sops decrypt .enc.local.env > .env

Edit deployment dotenv files with sops edit .enc.staging.env and sops edit .enc.production.env. Keep .env local and commit only encrypted files. See the Nuxt template guide for deployment commands.