Skip to content

Conversation

@directcuteo
Copy link
Contributor

@directcuteo directcuteo commented Nov 18, 2025

Summary

  • Changed frontend environment from compose to local as compose is not a valid environment in the frontend startup script
  • Exposed port 3000 for the mina-node HTTP API to allow frontend to connect to the backend

Problem

The docker-compose setup was experiencing a black screen issue where the frontend failed to start. The root cause was that MINA_FRONTEND_ENVIRONMENT: compose was not recognized by the frontend startup script, which only accepts: local, fuzzing, production, webnode, or staging.

Additionally, the mina-node HTTP API (running on port 3000) was not exposed, preventing the frontend from connecting to the backend even if it had started successfully.

Test plan

  • Run docker-compose up -d
  • Verify frontend starts without errors: docker-compose logs frontend
  • Access frontend at http://localhost:8070
  • Verify no black screen and frontend loads correctly
  • Verify frontend can connect to backend API at http://localhost:3000/status

@github-actions
Copy link

github-actions bot commented Nov 18, 2025

OCaml Reference Validation Results

Repository: https://github.com/MinaProtocol/mina.git
Branch: compatible
Status: ✓ Validation passed

Click to see full validation output
Checking OCaml references against https://github.com/MinaProtocol/mina.git (branch: compatible)
Fetching current commit from compatible...
Current OCaml commit: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b

Validating references...
========================
✓ VALID: ledger/src/account/account.rs -> src/lib/mina_base/account.ml L:201-224
  ⚠ STALE COMMIT: fc6be4c58091c761f827c858229c2edf9519e941 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/for_tests.rs -> src/lib/transaction_logic/mina_transaction_logic.ml L:2285-2285
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/for_tests.rs -> src/lib/transaction_logic/mina_transaction_logic.ml L:2351-2356
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/for_tests.rs -> src/lib/transaction_logic/mina_transaction_logic.ml L:2407
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/mod.rs -> src/lib/mina_base/transaction_status.ml L:9-51
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/mod.rs -> src/lib/mina_base/transaction_status.ml L:452-454
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/mod.rs -> src/lib/mina_base/with_status.ml L:6-10
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/mod.rs -> src/lib/mina_base/fee_transfer.ml L:76-80
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/mod.rs -> src/lib/mina_base/fee_transfer.ml L:68-69
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/mod.rs -> src/lib/mina_base/coinbase.ml L:17-21
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/mod.rs -> src/lib/transaction/transaction.ml L:8-11
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/signed_command.rs -> src/lib/mina_base/signed_command_payload.ml L:34-48
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/signed_command.rs -> src/lib/mina_base/stake_delegation.ml L:11-13
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/signed_command.rs -> src/lib/mina_base/signed_command_payload.ml L:179-181
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/signed_command.rs -> src/lib/mina_base/signed_command_payload.ml L:239-243
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)
✓ VALID: ledger/src/scan_state/transaction_logic/signed_command.rs -> src/lib/mina_base/signed_command_payload.ml L:352-362
  ⚠ STALE COMMIT: 5da42ccd72e791f164d4d200cf1ce300262873b3 (current: c88e0f882006a5a55bdb6b1c9f5a89d909820c9b)

Summary
=======
Total references found: 16
Valid references: 16
Invalid references: 0
Stale commits: 16

⚠ Warning: 16 reference(s) have stale commits
Run with --update to update them automatically

@github-actions
Copy link

github-actions bot commented Nov 18, 2025

✓ Code Reference Verification Passed

All code references in the documentation have been verified successfully!

Total references checked: 1
Valid references: 1

The documentation is in sync with the codebase on the develop branch.

@directcuteo directcuteo force-pushed the 1644-resolve-black-screen-on-frontend-within-the-docker-compose branch 2 times, most recently from 7cdc842 to 3d596e7 Compare November 19, 2025 08:01
0xMimir
0xMimir previously approved these changes Nov 19, 2025
Copy link
Contributor

@0xMimir 0xMimir left a comment

Choose a reason for hiding this comment

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

LGTM

richardpringle
richardpringle previously approved these changes Nov 19, 2025
Change frontend environment from 'compose' to 'local' as 'compose' is not
a valid environment in the frontend startup script. Expose port 3000 for
the mina-node HTTP API to allow frontend to connect to the backend.

This resolves the black screen issue where the frontend failed to start
because of an invalid environment configuration.
@directcuteo directcuteo dismissed stale reviews from richardpringle and 0xMimir via a4e81c1 November 19, 2025 16:17
@directcuteo directcuteo force-pushed the 1644-resolve-black-screen-on-frontend-within-the-docker-compose branch from 3d596e7 to a4e81c1 Compare November 19, 2025 16:17
@directcuteo directcuteo merged commit 6fc3f26 into develop Nov 19, 2025
75 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

Resolve black screen on frontend within the docker-compose

4 participants