Entry

A personal journal app with a modern frontend and a Go backend.

What Is Inside

• fox: frontend (Vite + TypeScript + React)
• ant: backend (Go + SQLite)

Quick Start (Local Development)

1) Prerequisites

• Go
• Node.js (with Corepack enabled)
• pnpm

2) Install frontend dependencies

cd fox
corepack enable
pnpm install
cd ..

3) Set required backend environment variable

ENTRY_AUTH_SECRET is required.

export ENTRY_AUTH_SECRET="replace-with-a-long-random-secret"

You can generate a random secret with:

openssl rand -base64 32

4) Run both backend + frontend

make dev

Open your browser to http://localhost:3000 to access the app.

Build Commands

make build

Test Commands

make test

Docker

Build image

Run from the repository root

docker build -f ant/Dockerfile -t entry-ant:latest .

Run container

docker run --name entry-ant \
  -e ENTRY_AUTH_SECRET="replace-with-a-long-random-secret" \
  -e ENTRY_PORT=3000 \
  -p 3000:3000 \
  entry-ant:latest

Run with persisted data

docker run --name entry-ant \
  -e ENTRY_AUTH_SECRET="replace-with-a-long-random-secret" \
  -e ENTRY_PORT=3000 \
  -e ENTRY_DATA_DIR=/var/lib/entry/data \
  -e ENTRY_DB_PATH=/var/lib/entry/sqlite/entry.db \
  -p 3000:3000 \
  -v "$(pwd)/ant/data:/var/lib/entry/data" \
  -v "$(pwd)/ant/sqlite:/var/lib/entry/sqlite" \
  entry-ant:latest

Docker Compose

docker compose -f ant/docker-compose.yml up --build

Environment Variables

Variable	Required	Default	Description
ENTRY_AUTH_SECRET	Yes	-	Secret used for auth/session signing
ENTRY_PORT	No	3000	Backend listen port
ENTRY_DATA_DIR	No	./data	Directory for app data
ENTRY_DB_PATH	No	<ENTRY_DATA_DIR>/entry.db	SQLite database path
ENTRY_DEV_PROXY	No	empty	Frontend dev proxy URL
ENTRY_READ_TIMEOUT	No	10s	HTTP read timeout
ENTRY_READ_HEADER_TIMEOUT	No	5s	HTTP read-header timeout
ENTRY_WRITE_TIMEOUT	No	15s	HTTP write timeout
ENTRY_IDLE_TIMEOUT	No	60s	HTTP idle timeout
ENTRY_REQUEST_TIMEOUT	No	15s	Request-level timeout
ENTRY_LIST_DEFAULT_LIMIT	No	30	Default list page size
ENTRY_LIST_MAX_LIMIT	No	100	Max list page size
ENTRY_SESSION_DURATION	No	168h	Session lifetime