Skip to content

feat: code restructuring to enable local build#309

Open
plakkara-bc wants to merge 5 commits into
devfrom
feat/local-run
Open

feat: code restructuring to enable local build#309
plakkara-bc wants to merge 5 commits into
devfrom
feat/local-run

Conversation

@plakkara-bc

@plakkara-bc plakkara-bc commented May 29, 2026

Copy link
Copy Markdown
Contributor

Description

Summary
Added support for running the application locally without requiring SSO/Keycloak authentication. This makes it easier for developers to test and debug the application without setting up a full SSO environment.

How it works
Frontend:

When VITE_APP_ENV=LOCAL, the app bypasses Keycloak and uses a mock user/token
No SSO server connection required
Backend:

When NODE_ENV=local, JWT signature verification is skipped
Tokens are still decoded to extract user info, but signatures aren't validated against Keycloak

Environment Variables to Enable Local Mode
Backend (.env):

NODE_ENV=local
USE_MOCK_DATA=true

Frontend (.env):
VITE_APP_ENV=LOCAL

Quick Start

  • Copy [.env.example] to [.env] in both frontend and backend
  • Set the values above
  • Run npm run start:dev in backend
  • Run npm run dev in frontend

⚠️ Warning
These settings should only be used for local development. Never deploy with NODE_ENV=local or VITE_APP_ENV=LOCAL in any shared environment.

@plakkara-bc plakkara-bc requested a review from mdiapenabc May 29, 2026 21:55

@mdiapenabc mdiapenabc left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's merge the other PR first

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants