18F’s flagship website
A detailed history of the work that went into developing this redesign can be found at 18F/beta.18f.gov.
Run each of the following steps to get the site up and running.
git clone firstname.lastname@example.org:18F/18f.gsa.gov
To dramatically reduce the build time, there are two commands that you can run instead of
./serve-fast: This will eliminate all of the blog posts and the search index, but generates all other pages
./serve-blog: This will eliminate all but the latest three blog posts, but keeps the rest of the site intact.
You should be able to see the site at: http://127.0.0.1:4000/site/
Alternative Installation using Docker
Using Docker can make dependencies management easier, but can also slow down your build time. You can find out more in this discussion
To try this out on MacOS:
- Install Docker Toolbox.
- Make sure Docker is running and
cdinto your project folder
docker-compose buildto build the docker image and its dependencies. You only need to build once, but if there was an error with the build , rebuild using the
--no-cacheoption like so
docker-compose build --no-cacheto avoid using the old version of the docker image.
docker-compose up. Note: if you want to run a single command and bypass your
Dockerfilefor debugging purposes, you can do like so
docker-compose run app <COMMAND>(for instance, you can run bundle
docker-compose run app bundle install)
- Visit http://192.168.99.100:4000 in your browser.
System security controls
- Federalist runs in its own organization and space in cloud.gov, which piggybacks on AWS GovCloud
- Federalist Admin: https://federalist.fr.cloud.gov/
- Federalist responds to a webhook on GitHub and runs Jekyll to generate static web files and puts them in an S3 bucket
- We map 18f.gsa.gov URL to the S3 bucket