Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions .env.example
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
#
# Decentra – local environment variables (example)
#
# Copy to `.env.local` (recommended) or `.env` and fill values.
# Files matching `.env*` are gitignored by default (except `.env.example`).
#
# Nuxt exposes variables prefixed with `NUXT_PUBLIC_` to the browser.
#

#
# Optional remote debug logging (default: console-only)
#
# When empty/unset: Decentra only logs to the browser console.
# When set: Decentra will POST debug payloads to this URL.
#
# Example (Cursor debug session ingest):
# NUXT_PUBLIC_DEBUG_LOG_INGEST_URL=http://127.0.0.1:7476/ingest/<id>
# NUXT_PUBLIC_DEBUG_LOG_SESSION_ID=<session>
# NUXT_PUBLIC_DEBUG_LOG_SESSION_HEADER=X-Debug-Session-Id
#
NUXT_PUBLIC_DEBUG_LOG_INGEST_URL=
NUXT_PUBLIC_DEBUG_LOG_SESSION_ID=
NUXT_PUBLIC_DEBUG_LOG_SESSION_HEADER=

4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- Sign-up entry point for delegated browser OAuth; runtime
`nuxt.public.siteUrl` / `matrixOidcClientId`; EN/DE i18n for callback and
error paths; README notes on HTTPS redirect requirements for matrix.org
- Account verification panel in settings with device verification (SAS)
and recovery key bootstrap for cross-signing (#69)
- Optional remote debug logging via `NUXT_PUBLIC_DEBUG_LOG_*` env vars and
`.env.example` template (#69)

### Changed

Expand Down
16 changes: 16 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,22 @@ npm run dev

Open [http://localhost:3000](http://localhost:3000).

### Optional debug logging (console vs. remote)

By default, Decentra logs debug traces only to the **browser console**.
You can optionally forward those traces to a remote ingest endpoint by
setting environment variables (recommended via a local untracked file):

```bash
cp .env.example .env.local
```

Then set one or more of:

- `NUXT_PUBLIC_DEBUG_LOG_INGEST_URL` (enables remote logging)
- `NUXT_PUBLIC_DEBUG_LOG_SESSION_ID` (optional)
- `NUXT_PUBLIC_DEBUG_LOG_SESSION_HEADER` (optional, e.g. `X-Debug-Session-Id`)

## Build & Preview

```bash
Expand Down
Loading
Loading