Welcome to Bedrock’s documentation!

bedrock is the project behind www.mozilla.org. It is as shiny, awesome, and open-sourcy 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
  • Docker Installation
  • Local Installation
• Run the tests
  • Docker
  • Local
• Make it run
  • Docker
  • Local
  • Browsersync
• Legal Docs
• Localization
• Feature Flipping (aka Switches)
  • Testing
  • Traffic Cop
  • Notes
• Localization
  • .lang files
  • l10n blocks
  • Currency
  • CSS
  • Staging Copy Changes
  • Locale-specific Templates
  • Specifying Active Locales in Views
  • Development
• Developing on Bedrock
  • Writing URL Patterns
  • Optimizing images
  • Embedding images
  • Writing Views
  • Coding Style Guides
  • Configuring your code editor
• How to contribute
  • Git workflow
  • Git commit messages
  • Submitting your work
  • Squashing your commits
  • Server architecture
  • Pushing to production
• Continuous Integration & Deployment
  • Tests in the lifecycle of a change
  • Pipeline integration
  • Known issues in Jenkins
• 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
  • Link Checks
• Managing Redirects
  • Add a redirect
  • Differences
  • Utilities
  • Testing redirects
• JavaScript Libraries
  • Mozilla Pager
  • Mozilla Accordion
  • Mozilla Image Lazy Loader
  • Mozilla Notification Banner
• Newsletters
  • Features
  • Newsletters
  • Bedrock and Basket
  • URLs
  • Configuration
  • Footer signup
  • Creating a signup page
• Using External Content Cards Data
  • Add to a View
  • Add to the Template
• Tabzilla
  • Translation and Update bar
• Mozilla.UITour
  • Introduction
  • Local development
  • Tracking Protection UITour
  • JavaScript API
• Send to Device widget
  • Usage
  • Geolocation Callback
  • Micro embedded form
• Firefox Accounts Referrals
  • Signup Form
  • Linking to accounts.firefox.com
  • Linking to monitor.firefox.com
  • Tracking Sign-ups / Sign-ins
  • Tracking External Referrers
  • Google Analytics Guidelines
• Funnel cakes and Partner Builds
  • Funnel cakes
  • Partner builds
• A/B Testing
  • Coding the variants
  • Traffic Cop
  • Recording the data
  • Tests
  • A/B Test PRs that might have useful code to reuse
• Analytics
  • Google Tag Manager (GTM)
  • The GTM DataLayer
  • DataLayer Push Example
  • The Core DataLayer Object
  • GTM Listeners & Data Attributes
  • Some notes on how this looks in GA
• Stub Attribution
  • How does it work in bedrock?
  • Local testing
  • Measuring campaigns and experiments
• Architectural Decision Records
  • 1. Record architecture decisions
• Browser Support
  • Technical details
  • Browser Support Matrix (Updated 20190809)
  • Exceptions (Updated 20190809)
  • Future Support (Updated 20190809)