dp-frontend-homepage-controller

README

dp-frontend-homepage-controller

Getting started

To run this service

1. Run sixteens locally using npm run dev
2. Run make debug to start the service on http://localhost:24400

Dependencies

• sixteens - Serves CSS and JS for the page
• dp-design-system
• golang 1.24.x
• zebedee
• dp-topic-api
• No further dependencies other than those defined in go.mod

Configuration

Config	Description	Default
API_ROUTER_URL	The URL of the dp-api-router	http://localhost:23200/v1
BIND_ADDR	The Port to run on	:24400
CACHE_CENSUS_TOPICS_UPDATE_INTERVAL	Duration for census topic cache updates	1 minute
CACHE_NAVIGATION_UPDATE_INTERVAL	Duration for navigation cache updates	1 minute
CACHE_UPDATE_INTERVAL	Duration for homepage cache updation	10 seconds
CENSUS_TOPIC_ID	Root census id (for getting census topics)	4445
DATASET_FINDER_ENABLED	Displays link to dataset finder	false
DEBUG
ENABLE_CENSUS_TOPIC_SUBSECTION	Displays topics subsection	false
ENABLE_CUSTOM_DATASET	Displays link to custom dataset builder	false
ENABLE_GET_DATA_CARD	Displays Get Data Card	false
ENABLE_NEW_NAVBAR	Enables Topic API driven Nav bar	false
FEEDBACK_API_URL
GRACEFUL_SHUTDOWN_TIMEOUT	Time to wait during graceful shutdown	5 seconds
HEALTHCHECK_CRITICAL_TIMEOUT	Amount of time to pass since last healthy health check to be deemed a critical failure	90 seconds
HEALTHCHECK_INTERVAL	Interval between health checks	30 seconds
OTEL_BATCH_TIMEOUT	5s	Interval between pushes to OT Collector
OTEL_EXPORTER_OTLP_ENDPOINT	http://localhost:4317	URL for OpenTelemetry endpoint
OTEL_SERVICE_NAME	"dp-frontend-homepage-controller"	Service name to report to telemetry tools
OTEL_ENABLED	false	Feature flag to enable OpenTelemetry
IS_PUBLISHING_MODE	Mode in which service is running	false
PATTERN_LIBRARY_ASSETS_PATH
SERVICE_AUTH_TOKEN
SIXTEENS_VERSION	Homepage still uses a Sixteens version for styling
SITE_DOMAIN		localhost
SUPPORTED_LANGUAGES	Languages which are supported separated by comma	en,cy

Contributing

See CONTRIBUTING for details.

License

Copyright © 2025, Office for National Statistics (https://www.ons.gov.uk)

Released under MIT license, see LICENSE for details.