# Journaley

Journaley is a simple, modern journaling app built with SvelteKit, Tailwind CSS, shadcn-svelte conventions, Convex, and Convex Auth.

## Features

- Authenticated daily markdown entries with live Convex data.
- Dashboard with recent entries, streaks, activity, mood counts, and tag insights.
- Entry workspace with create/edit dialog, markdown preview, date, mood, pin/archive state, tags, search, filters, and sorting.
- Normalized tagging with usage counts and entry/tag joins.
- Convex full-text search over title, body text, mood, and tags.
- Warm light theme, dark mode, and basic user settings.

## Development

Install dependencies:

```sh
pnpm install
```

Push Convex functions and regenerate types:

```sh
CONVEX_AGENT_MODE=anonymous npx convex dev --once
```

Start the SvelteKit app:

```sh
pnpm dev
```

The local app runs at `http://localhost:5173`. Convex local deployment values live in `.env.local`.

## Production App

This app uses `@sveltejs/adapter-node`, so production builds create a Node server in `build/`.

Set these environment variables in your production app host before building and running:

```sh
PUBLIC_CONVEX_URL=https://your-production-deployment.convex.cloud
PUBLIC_CONVEX_SITE_URL=https://your-production-deployment.convex.site
HOST=0.0.0.0
PORT=3000
```

Build and validate the production app:

```sh
pnpm prod:check
```

Build only:

```sh
pnpm build
```

Run the production server:

```sh
pnpm start
```

For a single local smoke test that builds and starts the production server:

```sh
pnpm prod
```

## Docker Deployment

The root `Dockerfile` builds the SvelteKit Node server with pnpm and runs it with `node build`.

Build locally:

```sh
docker build \
  --build-arg PUBLIC_CONVEX_URL=https://your-production-deployment.convex.cloud \
  --build-arg PUBLIC_CONVEX_SITE_URL=https://your-production-deployment.convex.site \
  -t journaley .
```

Run locally:

```sh
docker run --rm -p 3000:3000 \
  -e PUBLIC_CONVEX_URL=https://your-production-deployment.convex.cloud \
  -e PUBLIC_CONVEX_SITE_URL=https://your-production-deployment.convex.site \
  -e HOST=0.0.0.0 \
  -e PORT=3000 \
  journaley
```

For Dokploy, choose a Dockerfile deployment, keep the Dockerfile path as `Dockerfile`, expose container port `3000`, and set the same environment variables in the Dokploy app settings. The public Convex URLs are also defined as Docker build args because SvelteKit's public static env values are compiled into the app during the image build.

## Auth

This project uses Convex Auth with email/password for local development. The initializer created `convex/auth.config.ts`, `convex/auth.ts`, and `convex/http.ts`; the frontend uses `@mmailaender/convex-auth-svelte` for SvelteKit auth state and auth routes.

For production Convex Auth, make sure your production Convex deployment has its auth environment configured, including `SITE_URL`, `JWT_PRIVATE_KEY`, and `JWKS`. If sign-in returns a generic Convex server error, production auth keys/site URL are the first things to verify.

## Scripts

- `pnpm dev` starts SvelteKit.
- `pnpm build` builds the app.
- `pnpm start` runs the built Node server from `build/`.
- `pnpm prod` builds and starts the production server locally.
- `pnpm prod:check` runs checks, linting, and a production build.
- `pnpm preview` previews the production build.
- `pnpm check` runs Svelte and TypeScript checks.
- `pnpm lint` runs Prettier checks and ESLint.
- `pnpm format` formats the codebase.

## Project Layout

- `convex/` contains schema, auth, entries, tags, settings, and analytics functions.
- `src/routes/` contains SvelteKit pages and layout.
- `src/lib/components/` contains reusable UI, logo, theme, and markdown components.
- `static/favicon.svg` contains the Journaley mark.