Overview
Swift.org website goals include:
- Welcome the curious about the Swift programming language.
- Share knowledge with the Swift users community and prospective users, including instructions for getting started with Swift as easily as possible, user guides, best practices, API documentation and feature announcements.
- Share knowledge with the Swift contributors community and prospective contributors, including contribution guides, technical details that assist contributions, project governance and legal information.
- Highlight community driven initiatives and technical work that have broad applicability to Swift users in all or some of its core usage domains.
See website overview for more information about the Swift.org website goals, content governance and contribution guidelines.
Technical
Swift.org uses Jekyll, a blog-aware, static site generator in Ruby.
Running locally
Requirements
- Git
- Ruby 3.3 or higher (a Ruby installation manager, such as rbenv or RVM is recommended, but not required)
- Bundler
To run the site locally, enter the following commands into a terminal window:
git clone https://github.com/swiftlang/swift-org-website.git cd swift-org-website bundle install LC_ALL=en_us.UTF-8 bundle exec jekyll serve --config _config.yml,_config_dev.yml open "http://localhost:4000"
If you’d like to contribute to this project, please run Prettier before submitting your pull request to ensure consistent code style across the project.
Requirements
npm install
npm run prettify
Running with Apple Container
On macOS 26 and later, you can use the Apple Container tool to host and run the website.
First install and run container:
brew install container brew services start container
Then build and run the site:
make build make website
The website will be available at http://localhost:4000
Running in Docker
First build the site with Docker Compose:
docker compose run build
Then you can run the site:
docker compose up website
The website will be available on http://localhost:4000