Kato

Kato is a Nuxt-based productivity app focused on a calm landing experience, rotating wallpapers, daily affirmations, and a small authenticated user area.

Current Features

• Daily wallpaper selection backed by the database
• Daily affirmations generated by scheduled scripts
• Email/password signup and login flows
• Protected profile page for authenticated users
• Example CRUD endpoints implemented with both Prisma and Kysely

Stack

• Nuxt 4
• Nuxt UI
• TypeScript
• Prisma
• Kysely
• PostgreSQL
• Zod
• ESLint and Prettier

Getting Started

Install dependencies with pnpm:

pnpm install

Copy the example environment and fill in the values you need:

cp .env.example .env

Start the local Postgres container if you want the bundled development database:

docker compose -f dev-docker-compose.yaml up -d

Run Prisma generation or schema sync as needed:

pnpm prisma:generate
pnpm prisma:db:push

Start the development server:

pnpm dev

Useful Commands

pnpm lint
pnpm build
pnpm preview
pnpm scripts:generate:affirmations
pnpm scripts:generate:background:images

Project Layout

• app/: Nuxt pages, layouts, components, middleware, and global styles
• server/: API routes, middleware, and database utilities
• scripts/: Scheduled jobs for affirmations and wallpapers
• prisma/: Prisma schema and migration configuration
• shared/generated/: Generated Prisma and Kysely clients

Commenting Pass

This repository now includes concise top-level comments across the hand-authored files that support comments. Generated output, lockfiles, binary assets, and formats that do not safely support comments were intentionally left untouched.