Idea Town

Idea Town is an opt-in platform that allows us to perform controlled tests of new high-visibility product concepts in the general release channel of Firefox.

Idea Town is not intended to replace trains for most features, nor is it a test bed for concepts we do not believe have a strong chance of shipping in general release. Rather, it is reserved for features that require user feedback, testing, and tuning before they ship with the browser.

Repositories

• idea-town - Idea Town server and front-end
• idea-town-splash - Teaser site for collecting emails

More Information

• Wiki: https://wiki.mozilla.org/Idea_Town
• IRC: #ideatown on irc.mozilla.org

Development

Quickstart

This project uses Docker in development. You'll get a lot of benefit by acquainting yourself with Docker and its documentation. However, you can get started on Idea Town development with a minimum of Docker know-how:

OS X hosts

1. Install Docker Toolbox

2. Make sure you have a default Docker machine:

docker-machine create -driver virtualbox default

3. Make sure your shell can see the default Docker machine:

eval "$(docker-machine env default)"

4. Check the IP address of the default Docker machine:

docker-machine ip default

5. Use this IP address to add an entry for ideatown.dev in /etc/hosts:

192.168.99.100 ideatown.dev

You can do this manually, or the bin/update-ip.sh script can take care of this for you.

6. Create and setup the Docker containers (this will take some time):

docker-compose up

Ubuntu Linux hosts

1. Install Docker

2. Install Docker Compose

3. Add an entry for ideatown.dev in /etc/hosts:

127.0.0.1 ideatown.dev

You can do this manually, or the bin/update-ip.sh script can take care of this for you.

4. Create and setup the Docker containers (this will take some time):

sudo docker-compose up

Windows hosts

• Help wanted: Getting things working on Windows may be similar to OS X, but the team has little experience with that environment.

Next Steps

• Start editing files - changes should be picked up automatically.

• Visit the Django server, using the hostname you added to /etc/hosts:

  http://ideatown.dev:8000/

• Visit Django admin, login with username admin and password admin:

  http://ideatown.dev:8000/admin/

• For further reading:

  • README-DOCKER.md - for more hints & tips on Docker in development, including how to set up custom configurations and run common tests & checks.

  • tox.ini - to see what checks are run automatically in Travis CI, which you should ensure pass locally before submitting a Pull Request on GitHub

  • addon/README.md - for more details on the addon this site uses to enable advanced features.

  • addon-api/README.md - for details of the npm package.