GoTodo

GoTodo is a full-stack todo application with an Ionic/Angular client and a Go backend. It supports account signup with email confirmation, login/logout, todo management, password reset, password change, email change, and account deletion.

Stack

• Client: Angular 22, Ionic 8, Angular signal forms, httpResource, RxJS
• Server: Go 1.26, chi, SQLBoiler, scs sessions, PostgreSQL
• Emails: MJML 5 templates compiled into Go template files

Requirements

• Node.js 20 or newer and npm
• Go 1.26 or newer
• Docker for the local PostgreSQL and Inbucket services

Client

cd client
npm install
npm start

The Angular dev server uses proxy.conf.json to forward API requests to the backend on http://localhost:8080.

Useful client commands:

npm run lint
npm run build
npm run serve-dist

npm run build updates src/environments/environment.prod.ts, builds the production app into client/dist/app, and runs bread-compressor on the browser output.

Server

Start PostgreSQL and Inbucket:

cd server
docker compose up -d

The default backend configuration in server/app.env uses:

• Database: gotodo
• User/password: gotodo / gotodo
• PostgreSQL address: 127.0.0.1:5432
• HTTP address: localhost:8080
• SMTP address: localhost:2500
• App URL for emails: http://localhost:8100/

Run the backend:

cd server
go run gotodo.rasc.ch/cmd/web

Run backend tests:

cd server
go test ./...

Emails

cd emails
npm install
npm start

npm start compiles emails/src/*.mjml to emails/output and then runs cmd/mailgen to update server/mails/*.tmpl.

Development Notes

• API routes are served under /v1.
• Generated TypeScript API types live in client/src/app/api/types.ts.
• SQLBoiler models are checked into server/internal/models.
• Database migrations live in server/migrations.

Verification

Current health checks:

cd client && npm run lint
cd client && npm run build
cd emails && npm start
cd server && go test ./...