Welcome to Bedrock’s documentation!

bedrock is the project behind www.mozilla.org. It is as shiny, awesome, and open-source as always. Perhaps even a little more.

bedrock is a web application based on Django, a Python web application framework.

Patches are welcome! Feel free to fork and contribute to this project on Github.

Contents

• Installing Bedrock
  • Installation Methods
  • Run the tests
  • Make it run
  • Localization
  • Feature Flipping (aka Switches)
• Localization
  • Fluent
  • All
  • Adding new L10N integrations
• Developing on Bedrock
  • Managing Dependencies
  • Asset Management and Bundling
  • Writing JavaScript
  • Writing URL Patterns
  • Finding Templates by URL
  • Optimizing Images
  • Embedding Images
  • Using Large Assets
  • Writing Migrations
  • Writing Views
  • Coding Style
  • Test coverage
  • Configuring your Code Editor
  • Working with Protocol Design System
• How to contribute
  • Git workflow
  • Git commit messages
  • Submitting your work
  • Squashing your commits
  • Deploying your code
• Continuous Integration & Deployment
  • Deployed site URLs
  • Tests in the lifecycle of a change
• Front-end testing
  • Installation
  • Running Jasmine tests using Karma
  • Running functional tests
  • Writing Selenium tests
  • Debugging Selenium
  • Guidelines for writing functional tests
  • Testing Basket email forms
  • Headless tests
• Managing Redirects
  • Add a redirect
  • Differences
  • Utilities
  • Testing redirects
• Newsletters
  • Features
  • Newsletters
  • Bedrock and Basket
  • URLs
  • Footer sign-up
• Contentful CMS Integration
  • Overview
  • Contentful Apps
  • Content Models
  • Adding support for a new product icon, size, folder
  • Rich Text Rendering
  • L10N
  • Assets
  • Preview
  • Roles/Permissions
  • Development practices
  • Useful Contentful Docs
  • Assumptions we still need to deal with
  • Legacy
• Sitemaps
  • Quick summary
• Using External Content Cards Data
  • Add to a View
  • Add to the Template
• Banners
  • Creating page banners
• Mozilla.UITour
  • Introduction
  • Local development
  • JavaScript API
• Send to Device Widget
  • Usage
• Firefox Download Buttons
  • Which button should I use?
  • Documentation
  • External referrers
• Firefox Accounts Helpers
  • Firefox Account Sign-up Form
  • Firefox Account Links
  • Firefox Monitor Links
  • Pocket Links
  • Common FxA Parameters
  • Mozilla VPN Links
  • Firefox Sync and UITour
  • Testing Signup Flows
• Funnel cakes and Partner Builds
  • Funnel cakes
  • Partner builds
• A/B Testing
  • Convert experiments
  • Traffic Cop experiments
  • Avoiding experiment collisions
• Mozilla VPN Subscriptions
  • Server architecture
  • Adding new countries for VPN
  • Excluded countries
• Attribution
  • Website analytics
  • Firefox desktop attribution
  • Firefox mobile attribution
  • Firefox Accounts attribution
  • Mozilla VPN affiliate attribution
• Architectural Decision Records
  • 1. Record architecture decisions
  • 2. Move CI/CD Pipelines to Gitlab
  • 3. Use Cloudflare Workers and Convert for multi-variant testing
  • 4. Use Fluent For Localization
  • 5. Use a Single Docker Image For All Deployments
  • 6. Revise tooling for Python dependency management
  • 7. Further revise tooling for Python dependency management
  • 8. Move Demos To GCP
  • 9. Manage Contentful schema state via migrations
  • 10. Move CI to Github Actions for Unit and Integration tests
  • 11. Use StatsD for metrics collection
• Browser Support
  • Browser Support Matrix (Updated 2022-07-06)
  • Delivering basic support
  • Delivering degraded support
  • Exceptions (Updated 2019-06-11)