# README
dp-frontend-homepage-controller
Getting started
To run this service
- Run sixteens locally using
npm run dev
- 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.
# Packages
assets in locale and templates folders are converted into Go source code with go-bindata the data.go file in this package is auto generated through the generate-dev and generate-prod tasks in the Makefile.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author