alphagov/whitehall

Stars
833
Rank 54,737 (Top 2 %)
Language
Ruby
License
MIT License
Created about 13 years ago
Updated over 1 year ago

alphagov/whitehall

alphagov

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Publishes government content on GOV.UK

Whitehall

Whitehall is deployed in two modes:

'admin' for publishers to create and manage content (e.g. http://whitehall-admin.dev.gov.uk/government/admin/news/new)
'frontend' for rendering content to the public that has yet to be migrated to using Publishing API (see live examples that follow)

Live examples (public facing APIs)

Governments: https://www.gov.uk/api/governments
World Locations: https://www.gov.uk/api/world-locations

Live examples (public facing frontend)

CSV Previews

CSV Preview pages: https://assets.publishing.service.gov.uk/government/uploads/system/uploads/attachment_data/file/560889/LEMPRD_201610180000-CSV-GOVUK.csv/preview

World Information

Help and services around the world: https://www.gov.uk/world
Worldwide Organisation pages: https://www.gov.uk/world/organisations/british-embassy-paris

Running the Application

Use GOV.UK Docker to run any commands that follow.

Traditionally, the two sides of Whitehall are available on different domains in development, which reflect their counterparts in production:

While this usually results in different routing behaviour, in development all routes can be accessed from either domain, although the redirect behaviour may differ.

Nomenclature

Govspeak A variation of Markdown used throughout whitehall as the general publishing format

Technical documentation

This is a Ruby on Rails app, and should follow our Rails app conventions.

You can use the GOV.UK Docker environment to run the application and its tests with all the necessary dependencies. Follow the usage instructions to get started.

Running the test suite

These commands assume you have the GOV.UK Docker environment running and its binaries in your PATH.

# run all the test suites
govuk-docker-run bundle exec rake

Javascript unit tests can also be run separately:

# run all the JavaScript tests
govuk-docker-run bundle exec rake jasmine

Further documentation

See the docs/ directory.

Licence

govuk-frontend

GOV.UK Frontend contains the code you need to start building a user interface for government platforms and services.

accessible-autocomplete

An autocomplete component, built to be accessible.

govuk-design-system

One place for service teams to find styles, components and patterns for designing government services.

govuk_frontend_toolkit

❗️GOV.UK Frontend Toolkit is deprecated, and will only receive major bug fixes and security patches.

govuk-aws

The GOV.UK repository for our Migration to AWS

e-petitions

This is the code base for the UK Government's e-petitions service (https://petition.parliament.uk)

govuk-prototype-kit

Rapidly create HTML prototypes of GOV.UK services

govuk_elements

❗️GOV.UK Elements is deprecated, and will only receive major bug fixes and security patches.

router

HTTP router in front of GOV.UK to proxy to backend servers on a single domain.

government-service-design-manual

Government Service Design Manual

styleguides

GOV.UK coding standards and guidelines for other tools we use

smart-answers

Serves smart answers on GOV.UK

unicornherder

Unicorn Herder: manage daemonized (g)unicorns

magna-charta

Accessible, useful, beautiful barcharts from HTML tables.

govuk-puppet

Puppet manifests used to provision remaining parts of the legacy GOV.UK stack (as at Nov 2023: just Licensify left)

govuk_template

❗️GOV.UK Template is deprecated, and will only receive major bug fixes and security patches. A template containing the GOV.UK header and footer, and associated assets.

gds-way

How we build and operate products at GDS

govuk-developer-docs

📖 Tech docs for everyone working on GOV.UK

govuk-infrastructure

Terraform turnup automation for the EKS Kubernetes clusters that host GOV.UK. See https://github.com/alphagov/govuk-helm-charts for application config.

wcag-primer

Get up to speed with the Web Content Accessibility Guidelines

signon

Single sign-on service for GOV.UK

govspeak

Markdown extension library for Government editors

paas-cf

GOV.UK PaaS - Cloud Foundry

accessibility-tool-audit

Automated accessibility tools audit

tech-docs-template

A template for building technical documentation with a GOV.UK style

govuk-guix

Package, service and system definitions using GNU Guix for software and systems related to GOV.UK.

govuk_frontend_alpha

This repository will be archived.

notifications-api

GOV.UK Notify API

govuk_publishing_components

A gem to document and distribute frontend components for GOV.UK applications

Product-Managers-Learn-By-Doing

Things you should know how to do, to be a successful Product Manager

govuk-docker

GOV.UK development environment using Docker 🐳

design-principles

Serves /design-principles on GOV.UK

fabric-scripts

govuk-rfcs

GOV.UK staff use this repository as a forum to discuss and make technical decisions

cdn-acceptance-tests

CDN Acceptance Tests

terraform-provider-concourse

A terraform provider for Concourse

calendars

Serves /bank-holidays and /when-do-the-clocks-change on GOV.UK

government-frontend

Serves government pages on GOV.UK

publisher

Publishes mainstream content on GOV.UK

smokey

Smoke tests for GOV.UK

pay-publicapi

The Payments Public API in Java (Dropwizard)

puppet-auditd

Puppet module for Auditd

fourth-wall

Retired pull request and build status monitor

notifications-admin

GOV.UK Notify frontend application

paas-alpha-tsuru-terraform

spotlight

Hybrid rendering application for the Performance Platform using Backbone and D3

need-o-tron

paas-docker-cloudfoundry-tools

govuk-country-and-territory-autocomplete

An autocomplete widget that uses data from Country and Territory Register.

puppet-aptly

Puppet module for aptly

collections

Serves GOV.UK navigation pages, browse, topic, step-by-steps & services and information pages.

govuk-coronavirus-vulnerable-people-form

Helps the public get support during the COVID-19 pandemic

gsp

GSP is a container platform and curated suite of components helping government deploy, run, observe and secure their services

slimmer

Templating Rack middleware, injects standard header/footer and GOV.UK Components

content-publisher

Publishing application for GOV.UK

publishing-api

API to publish content on GOV.UK

frontend

Serves the homepage, transactions and some index pages on GOV.UK

puppet-skeleton

Skeleton project for infrastructure teams

gds-boxen

Apple Macbook setup via Puppet - forked from https://github.com/boxen/our-boxen

govuk-content-schemas

Definitions of the data formats used to represent content on GOV.UK

accessibility-personas

Experience the web as personas with access needs

data-ethics-and-society-reading-group

Data ethics and society reading group for cross government sessions on books and articles relating to ethics in data science

prototyping

Old tool for making prototypes. No longer maintained. Use https://github.com/alphagov/govuk_prototype_kit instead

search-api

Search API for GOV.UK

data-standards-authority

Collaboration space for working on data standards and guidance for the DSA

content-store

API for content on GOV.UK

prometheus-aws-configuration-beta

Terraform configuration to manage a Prometheus server running on AWS.

paas-alpha-tsuru-ansible

Ansible configs for Tsuru

gds-sso

OmniAuth adapter to allow apps to sign in via GOV.UK signon

govuk-frontend-docs

Technical documentation for GOV.UK Frontend

govuk_frontend_toolkit_gem

A gem wrapper around the govuk_frontend_toolkit files to enable easy integration with Rails

govuk-taxonomy-supervised-learning

Auto-tag govuk content to the collated legacy taxonomies

Jupyter Notebook

accessibility-community-notes-and-discussion

Draft accessibility guidance

alphagov.github.io

GitHub organisation site for GDS. Also an Apache Maven repository.

paas-billing

A Go application for generating billing data from cloudfoundry events

interaction-diagrams

Tooling to generate microservice interaction diagrams using wireshark and PCAP processing.

release

Helps deploying to GOV.UK

government-digital-strategy

Government Digital Strategy

govuk-browser-extension

Chrome and Firefox extension for developers working on GOV.UK.

verify-frontend

The frontend service for GOV.UK Verify

table-editor

Table editor for creating complex tables in HTML

govuk-terraform-provisioning

**DEPRECATED** Terraform configuration and utilities to provision parts of the GOV.UK AWS Infrastructure

pay-selfservice

Payments Team Self Service

fastly-configure

Configures GOV.UK Fastly setup via the command-line

govuk-related-links-recommender

Machine learning model to recommend related content

govuk_admin_template

[Deprecated] Styles, scripts and templates for building GOV.UK backend admin apps

static

GOV.UK static files and resources

notifications-net-client

.NET client for the GOV.UK Notify API

gds-nodejs-boilerplate

A Node.js project boilerplate for production apps

paas-cf-conduit

backdrop

Storing and querying data for the Performance Platform

datainsight-frontend

Public facing web app to display various measurements of the GOV.UK site

govuk-archive

aws-security-alarms

CloudTrail and CloudWatch configuration with some basic security alarms.

govuk-lda-tagger

An experiment of using the LDA machine learning algorithm to generate topics from documents and tag them with those topics

Jupyter Notebook

panopticon

Retired. App that holds some of the content on GOV.UK

seal

Slack bot that publishes a team's pull requests to their Slack channel

verify-service-provider

👑 ☑️ The easiest way to connect to GOV.UK Verify

paas-aiven-broker

A service broker to provide Aiven Elasticsearch and InfluxDB services to Cloud Foundry users

finder-frontend

Serves finder and search pages for GOV.UK