Skip to content

README.md

Latest commit

 

History

History
104 lines (80 loc) · 3.46 KB

README.md

File metadata and controls

104 lines (80 loc) · 3.46 KB
Raw

Login Example

This is a feature-bound auth example. The .gwdk files declare the login actions and session API, and GOWDK discovers matching Go handlers in the same feature package.

  • One generated binary is the default.
  • src/features/auth/auth.go implements Login, Logout, and Session.
  • Split frontend/backend binaries are optional and generated from the same declarations.
  • No hand-written JavaScript is used.
  • No HTML lives in Go code.

Files

  • gowdk.config.go: configures one-binary and split generated targets.
  • src/features/auth/login.page.gwdk: root login page with act login and api session.
  • src/features/auth/dashboard.page.gwdk: dashboard page with act logout.
  • src/features/auth/auth.go: same-package feature-bound handlers.
  • src/features/auth/login-app.cmp.gwdk: reusable login panel component.
  • src/features/auth/login-error.page.gwdk: failed-login route.
  • styles/auth.css: CSS input selected by pages with css auth.
  • .gowdk/output/login: inferred generated output for the one-binary target.
  • .gowdk/output/split: inferred generated output for the split target.
  • .gowdk/login: generated one-binary Go app source.
  • .gowdk/login-frontend and .gowdk/login-backend: generated split app sources.
  • bin/login: generated one-binary app.
  • bin/login-frontend and bin/login-backend: generated split binaries.

Run

This example fails closed: it refuses to authenticate unless you configure a signing secret and the demo password. The session cookie is Secure by default; over plain HTTP for local development you must opt out explicitly.

From this directory:

cd examples/login
export GOWDK_LOGIN_SECRET="$(head -c 32 /dev/urandom | base64)"  # required, >=32 bytes
export GOWDK_LOGIN_PASSWORD="demo-password"                      # required, no default
export GOWDK_COOKIE_INSECURE=true                                # local HTTP only; omit in production
make serve

Open http://127.0.0.1:8090/.

Use:

email: demo@example.com           # override with GOWDK_LOGIN_EMAIL
password: <GOWDK_LOGIN_PASSWORD>

The generated app calls auth.Login, sets a signed HttpOnly SameSite session cookie, and redirects to /dashboard. GET /api/session calls auth.Session. A real app must set a unique, high-entropy GOWDK_LOGIN_SECRET, use real credentials, and leave the cookie Secure (serve over HTTPS).

Split Mode

Split mode keeps the same .gwdk declarations but generates separate frontend and backend binaries. The frontend serves app output and proxies action/API routes to GOWDK_BACKEND_ORIGIN.

cd examples/login
make serve-split

Open:

frontend: http://127.0.0.1:8090/
backend:  http://127.0.0.1:8091/

Equivalent Commands

cd examples/login
go run ../../cmd/gowdk build --target login
GOWDK_ADDR=127.0.0.1:8090 bin/login

For split mode:

go run ../../cmd/gowdk build --target split
GOWDK_ADDR=127.0.0.1:8091 bin/login-backend
GOWDK_ADDR=127.0.0.1:8090 GOWDK_BACKEND_ORIGIN=http://127.0.0.1:8091 bin/login-frontend

Backend Routes

  • POST /: bound from act login to auth.Login.
  • POST /dashboard: bound from act logout to auth.Logout.
  • GET /api/session: bound from api session to auth.Session.

This example demonstrates action/API/session plumbing with signed cookies. The dashboard remains public so gowdk build works without generated-app guard hooks. For protected pages, the built-in auth addon, and native role guards, see examples/auth-guard/.