https://github.com/alphagov/transition
Managing redirects for sites moving to GOV.UK.
https://github.com/alphagov/transition
container govuk govuk-transition
Last synced: 3 days ago
JSON representation
Managing redirects for sites moving to GOV.UK.
- Host: GitHub
- URL: https://github.com/alphagov/transition
- Owner: alphagov
- License: mit
- Created: 2013-09-10T13:11:17.000Z (over 12 years ago)
- Default Branch: main
- Last Pushed: 2025-07-01T08:46:00.000Z (6 months ago)
- Last Synced: 2025-07-01T13:05:39.383Z (6 months ago)
- Topics: container, govuk, govuk-transition
- Language: Ruby
- Homepage: https://docs.publishing.service.gov.uk/apps/transition.html
- Size: 6.86 MB
- Stars: 13
- Watchers: 89
- Forks: 17
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Transition
Rails app for managing the transition of websites to GOV.UK. Specifically, it's for adding and deleting sites, hostnames, and mappings for use with [Bouncer](https://github.com/alphagov/bouncer).
## Technical documentation
This is a Ruby on Rails app, and should follow [our Rails app conventions](https://docs.publishing.service.gov.uk/manual/conventions-for-rails-applications.html).
You can use the [GOV.UK Docker environment](https://github.com/alphagov/govuk-docker) to run the application and its tests with all the necessary dependencies. Follow [the usage instructions](https://github.com/alphagov/govuk-docker#usage) to get started.
**Use GOV.UK Docker to run any commands that follow.**
### Relationship with Bouncer
Bouncer and Transition currently share a database. As a result, we aim to keep a
few of their dependencies in sync (on the same version), namely:
- rails (Transition) and activerecord (Bouncer)
- optic14n
### Running the tests
```
bundle exec rake
```
### Running the worker
```
bundle exec sidekiq -C config/sidekiq.yml
```
### Style guide
Available at /style, the guide documents how transition is using bootstrap, where the app has diverged from default
styles and any custom styles needed to fill in the gaps.
## Adding a new site
Follow the instructions in the [GOV.UK Developer docs](https://docs.publishing.service.gov.uk/manual/transition-a-site.html)
## Example application URLs
* https://transition.staging.publishing.service.gov.uk/
* https://transition.staging.publishing.service.gov.uk/organisations/air-accidents-investigation-branch
* https://transition.staging.publishing.service.gov.uk/sites/aaib
* https://transition.staging.publishing.service.gov.uk/sites/aaib/mappings/939694/edit
* https://transition.staging.publishing.service.gov.uk/sites/aaib/mappings/bulk_add_batches/new
* https://transition.staging.publishing.service.gov.uk/sites/aaib/mappings/import_batches/new
* https://transition.staging.publishing.service.gov.uk/sites/aaib/hits/summary
## Glossary of terms
A glossary of the terms used can be found in this [blog post](https://insidegovuk.blog.gov.uk/2014/03/17/transition-technical-glossary/).
## Licence
[MIT License](LICENCE)