Representable PA +

Representable is creating maps of communities to fight for equal and impartial representation. The core web app is written in Django with Javascript/HTML/CSS frontend and Postgres/PostGIS backend.

There is a mapping & visualization app that allows orgs and users to draw their communities of interests. This is written in React & built using createreactapp and Material UI.
In development is a dashboard component that allows orgs to define their turfs to do census outreach. This is build in Vue, Flask, and Airflow.

Documentation

Check out our Docs site for a guide to installing Representable and contributing to various parts of the site. If you find any issues, we would love to know! Please open an issue request for any incomplete documentation.

Quick start

cp .env.example .env # update the variables
docker compose up -d
docker compose exec app /bin/bash
# run once to: setup the database, superuser, and test the appexport DJANGO_SETTINGS_MODULE=representable.settings.dev python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
python manage.py loaddata states.json
python manage.py collectstatic
python manage.py test# run the django server
python manage.py runserver 0:8000 --settings=representable.settings.dev

In another terminal run

docker compose exec app-plus /bin/bash
uv run python app.py

If you need a live vue instance

docker compose exec app-plus /bin/bash
cd vue-project
bun run dev --port 8888 --host 0.0.0.0

Tips

If you update .env, you must run source .env to refresh it in your container.

General Issue Reporting

For bug reports and general feature requests, please open a Github issue. We welcome all feedback and suggestions!

Reporting Security Issues

We take security very seriously at Representable.org. Please send an email to team@representable.org with any security issues and we'll open a private issue request with your concerns. We aim to respond to all security issues in a timely manner.

Representable Contributors

Our core team of engineers is currently 6 members strong, though we've been supported by many others along the way. See more about our team and how we work at representable.org/about

Somya Arora
Kyle Barnes
Chukwuagoziem Uzoegwu
Jason Yuan
Anna Eaton
Izzy Zaller

Founders

Representable began as a final project for Princeton University course Advanced Programming Techniques, taught by Brian Kernighan. The original project team is:

Theodor Marcu
Lauren Johnston
Preeti Iyer
Somya Arora
Kyle Barnes

License

Representable is under the GPL-3.0 License.

Representable PA +

Representable is creating maps of communities to fight for equal and impartial representation. The core web app is written in Django with Javascript/HTML/CSS frontend and Postgres/PostGIS backend.

There is a mapping & visualization app that allows orgs and users to draw their communities of interests. This is written in React & built using createreactapp and Material UI.
In development is a dashboard component that allows orgs to define their turfs to do census outreach. This is build in Vue, Flask, and Airflow.

Documentation

Check out our Docs site for a guide to installing Representable and contributing to various parts of the site. If you find any issues, we would love to know! Please open an issue request for any incomplete documentation.

Quick start

cp .env.example .env # update the variables
docker compose up -d
docker compose exec app /bin/bash
# run once to: setup the database, superuser, and test the appexport DJANGO_SETTINGS_MODULE=representable.settings.dev python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
python manage.py loaddata states.json
python manage.py collectstatic
python manage.py test# run the django server
python manage.py runserver 0:8000 --settings=representable.settings.dev

In another terminal run

docker compose exec app-plus /bin/bash
uv run python app.py

If you need a live vue instance

docker compose exec app-plus /bin/bash
cd vue-project
bun run dev --port 8888 --host 0.0.0.0

Tips

If you update .env, you must run source .env to refresh it in your container.

General Issue Reporting

For bug reports and general feature requests, please open a Github issue. We welcome all feedback and suggestions!

Reporting Security Issues

We take security very seriously at Representable.org. Please send an email to team@representable.org with any security issues and we'll open a private issue request with your concerns. We aim to respond to all security issues in a timely manner.

Representable Contributors

Our core team of engineers is currently 6 members strong, though we've been supported by many others along the way. See more about our team and how we work at representable.org/about

Somya Arora
Kyle Barnes
Chukwuagoziem Uzoegwu
Jason Yuan
Anna Eaton
Izzy Zaller

Founders

Representable began as a final project for Princeton University course Advanced Programming Techniques, taught by Brian Kernighan. The original project team is:

Theodor Marcu
Lauren Johnston
Preeti Iyer
Somya Arora
Kyle Barnes

License

Representable is under the GPL-3.0 License.

Representable PA +

Representable is creating maps of communities to fight for equal and impartial representation. The core web app is written in Django with Javascript/HTML/CSS frontend and Postgres/PostGIS backend.

There is a mapping & visualization app that allows orgs and users to draw their communities of interests. This is written in React & built using createreactapp and Material UI.
In development is a dashboard component that allows orgs to define their turfs to do census outreach. This is build in Vue, Flask, and Airflow.

Documentation

Check out our Docs site for a guide to installing Representable and contributing to various parts of the site. If you find any issues, we would love to know! Please open an issue request for any incomplete documentation.

Quick start

cp .env.example .env # update the variables
docker compose up -d
docker compose exec app /bin/bash
# run once to: setup the database, superuser, and test the appexport DJANGO_SETTINGS_MODULE=representable.settings.dev python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
python manage.py loaddata states.json
python manage.py collectstatic
python manage.py test# run the django server
python manage.py runserver 0:8000 --settings=representable.settings.dev

In another terminal run

docker compose exec app-plus /bin/bash
uv run python app.py

If you need a live vue instance

docker compose exec app-plus /bin/bash
cd vue-project
bun run dev --port 8888 --host 0.0.0.0

Tips

If you update .env, you must run source .env to refresh it in your container.

General Issue Reporting

For bug reports and general feature requests, please open a Github issue. We welcome all feedback and suggestions!

Reporting Security Issues

We take security very seriously at Representable.org. Please send an email to team@representable.org with any security issues and we'll open a private issue request with your concerns. We aim to respond to all security issues in a timely manner.

Representable Contributors

Our core team of engineers is currently 6 members strong, though we've been supported by many others along the way. See more about our team and how we work at representable.org/about

Somya Arora
Kyle Barnes
Chukwuagoziem Uzoegwu
Jason Yuan
Anna Eaton
Izzy Zaller

Founders

Representable began as a final project for Princeton University course Advanced Programming Techniques, taught by Brian Kernighan. The original project team is:

Theodor Marcu
Lauren Johnston
Preeti Iyer
Somya Arora
Kyle Barnes

License

Representable is under the GPL-3.0 License.

Representable PA +

Representable is creating maps of communities to fight for equal and impartial representation. The core web app is written in Django with Javascript/HTML/CSS frontend and Postgres/PostGIS backend.

There is a mapping & visualization app that allows orgs and users to draw their communities of interests. This is written in React & built using createreactapp and Material UI.
In development is a dashboard component that allows orgs to define their turfs to do census outreach. This is build in Vue, Flask, and Airflow.

Documentation

Check out our Docs site for a guide to installing Representable and contributing to various parts of the site. If you find any issues, we would love to know! Please open an issue request for any incomplete documentation.

Quick start

cp .env.example .env # update the variables
docker compose up -d
docker compose exec app /bin/bash
# run once to: setup the database, superuser, and test the appexport DJANGO_SETTINGS_MODULE=representable.settings.dev python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
python manage.py loaddata states.json
python manage.py collectstatic
python manage.py test# run the django server
python manage.py runserver 0:8000 --settings=representable.settings.dev

In another terminal run

docker compose exec app-plus /bin/bash
uv run python app.py

If you need a live vue instance

docker compose exec app-plus /bin/bash
cd vue-project
bun run dev --port 8888 --host 0.0.0.0

Tips

If you update .env, you must run source .env to refresh it in your container.

General Issue Reporting

For bug reports and general feature requests, please open a Github issue. We welcome all feedback and suggestions!

Reporting Security Issues

We take security very seriously at Representable.org. Please send an email to team@representable.org with any security issues and we'll open a private issue request with your concerns. We aim to respond to all security issues in a timely manner.

Representable Contributors

Our core team of engineers is currently 6 members strong, though we've been supported by many others along the way. See more about our team and how we work at representable.org/about

Somya Arora
Kyle Barnes
Chukwuagoziem Uzoegwu
Jason Yuan
Anna Eaton
Izzy Zaller

Founders

Representable began as a final project for Princeton University course Advanced Programming Techniques, taught by Brian Kernighan. The original project team is:

Theodor Marcu
Lauren Johnston
Preeti Iyer
Somya Arora
Kyle Barnes

License

Representable is under the GPL-3.0 License.

Representable PA +

Representable is creating maps of communities to fight for equal and impartial representation. The core web app is written in Django with Javascript/HTML/CSS frontend and Postgres/PostGIS backend.

There is a mapping & visualization app that allows orgs and users to draw their communities of interests. This is written in React & built using createreactapp and Material UI.
In development is a dashboard component that allows orgs to define their turfs to do census outreach. This is build in Vue, Flask, and Airflow.

Documentation

Check out our Docs site for a guide to installing Representable and contributing to various parts of the site. If you find any issues, we would love to know! Please open an issue request for any incomplete documentation.

Quick start

cp .env.example .env # update the variables
docker compose up -d
docker compose exec app /bin/bash
# run once to: setup the database, superuser, and test the appexport DJANGO_SETTINGS_MODULE=representable.settings.dev python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
python manage.py loaddata states.json
python manage.py collectstatic
python manage.py test# run the django server
python manage.py runserver 0:8000 --settings=representable.settings.dev

In another terminal run

docker compose exec app-plus /bin/bash
uv run python app.py

If you need a live vue instance

docker compose exec app-plus /bin/bash
cd vue-project
bun run dev --port 8888 --host 0.0.0.0

Tips

If you update .env, you must run source .env to refresh it in your container.

General Issue Reporting

For bug reports and general feature requests, please open a Github issue. We welcome all feedback and suggestions!

Reporting Security Issues

We take security very seriously at Representable.org. Please send an email to team@representable.org with any security issues and we'll open a private issue request with your concerns. We aim to respond to all security issues in a timely manner.

Representable Contributors

Our core team of engineers is currently 6 members strong, though we've been supported by many others along the way. See more about our team and how we work at representable.org/about

Somya Arora
Kyle Barnes
Chukwuagoziem Uzoegwu
Jason Yuan
Anna Eaton
Izzy Zaller

Founders

Representable began as a final project for Princeton University course Advanced Programming Techniques, taught by Brian Kernighan. The original project team is:

Theodor Marcu
Lauren Johnston
Preeti Iyer
Somya Arora
Kyle Barnes

License

Representable is under the GPL-3.0 License.

Representable PA +

Representable is creating maps of communities to fight for equal and impartial representation. The core web app is written in Django with Javascript/HTML/CSS frontend and Postgres/PostGIS backend.

There is a mapping & visualization app that allows orgs and users to draw their communities of interests. This is written in React & built using createreactapp and Material UI.
In development is a dashboard component that allows orgs to define their turfs to do census outreach. This is build in Vue, Flask, and Airflow.

Documentation

Check out our Docs site for a guide to installing Representable and contributing to various parts of the site. If you find any issues, we would love to know! Please open an issue request for any incomplete documentation.

Quick start

cp .env.example .env # update the variables
docker compose up -d
docker compose exec app /bin/bash
# run once to: setup the database, superuser, and test the appexport DJANGO_SETTINGS_MODULE=representable.settings.dev python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
python manage.py loaddata states.json
python manage.py collectstatic
python manage.py test# run the django server
python manage.py runserver 0:8000 --settings=representable.settings.dev

In another terminal run

docker compose exec app-plus /bin/bash
uv run python app.py

If you need a live vue instance

docker compose exec app-plus /bin/bash
cd vue-project
bun run dev --port 8888 --host 0.0.0.0

Tips

If you update .env, you must run source .env to refresh it in your container.

General Issue Reporting

For bug reports and general feature requests, please open a Github issue. We welcome all feedback and suggestions!

Reporting Security Issues

We take security very seriously at Representable.org. Please send an email to team@representable.org with any security issues and we'll open a private issue request with your concerns. We aim to respond to all security issues in a timely manner.

Representable Contributors

Our core team of engineers is currently 6 members strong, though we've been supported by many others along the way. See more about our team and how we work at representable.org/about

Somya Arora
Kyle Barnes
Chukwuagoziem Uzoegwu
Jason Yuan
Anna Eaton
Izzy Zaller

Founders

Representable began as a final project for Princeton University course Advanced Programming Techniques, taught by Brian Kernighan. The original project team is:

Theodor Marcu
Lauren Johnston
Preeti Iyer
Somya Arora
Kyle Barnes

License

Representable is under the GPL-3.0 License.

Representable PA +

Representable is creating maps of communities to fight for equal and impartial representation. The core web app is written in Django with Javascript/HTML/CSS frontend and Postgres/PostGIS backend.

There is a mapping & visualization app that allows orgs and users to draw their communities of interests. This is written in React & built using createreactapp and Material UI.
In development is a dashboard component that allows orgs to define their turfs to do census outreach. This is build in Vue, Flask, and Airflow.

Documentation

Check out our Docs site for a guide to installing Representable and contributing to various parts of the site. If you find any issues, we would love to know! Please open an issue request for any incomplete documentation.

Quick start

cp .env.example .env # update the variables
docker compose up -d
docker compose exec app /bin/bash
# run once to: setup the database, superuser, and test the appexport DJANGO_SETTINGS_MODULE=representable.settings.dev python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
python manage.py loaddata states.json
python manage.py collectstatic
python manage.py test# run the django server
python manage.py runserver 0:8000 --settings=representable.settings.dev

In another terminal run

docker compose exec app-plus /bin/bash
uv run python app.py

If you need a live vue instance

docker compose exec app-plus /bin/bash
cd vue-project
bun run dev --port 8888 --host 0.0.0.0

Tips

If you update .env, you must run source .env to refresh it in your container.

General Issue Reporting

For bug reports and general feature requests, please open a Github issue. We welcome all feedback and suggestions!

Reporting Security Issues

We take security very seriously at Representable.org. Please send an email to team@representable.org with any security issues and we'll open a private issue request with your concerns. We aim to respond to all security issues in a timely manner.

Representable Contributors

Our core team of engineers is currently 6 members strong, though we've been supported by many others along the way. See more about our team and how we work at representable.org/about

Somya Arora
Kyle Barnes
Chukwuagoziem Uzoegwu
Jason Yuan
Anna Eaton
Izzy Zaller

Founders

Representable began as a final project for Princeton University course Advanced Programming Techniques, taught by Brian Kernighan. The original project team is:

Theodor Marcu
Lauren Johnston
Preeti Iyer
Somya Arora
Kyle Barnes

License

Representable is under the GPL-3.0 License.

Representable PA +

Representable is creating maps of communities to fight for equal and impartial representation. The core web app is written in Django with Javascript/HTML/CSS frontend and Postgres/PostGIS backend.

There is a mapping & visualization app that allows orgs and users to draw their communities of interests. This is written in React & built using createreactapp and Material UI.
In development is a dashboard component that allows orgs to define their turfs to do census outreach. This is build in Vue, Flask, and Airflow.

Documentation

Check out our Docs site for a guide to installing Representable and contributing to various parts of the site. If you find any issues, we would love to know! Please open an issue request for any incomplete documentation.

Quick start

cp .env.example .env # update the variables
docker compose up -d
docker compose exec app /bin/bash
# run once to: setup the database, superuser, and test the appexport DJANGO_SETTINGS_MODULE=representable.settings.dev python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
python manage.py loaddata states.json
python manage.py collectstatic
python manage.py test# run the django server
python manage.py runserver 0:8000 --settings=representable.settings.dev

In another terminal run

docker compose exec app-plus /bin/bash
uv run python app.py

If you need a live vue instance

docker compose exec app-plus /bin/bash
cd vue-project
bun run dev --port 8888 --host 0.0.0.0

Tips

If you update .env, you must run source .env to refresh it in your container.

General Issue Reporting

For bug reports and general feature requests, please open a Github issue. We welcome all feedback and suggestions!

Reporting Security Issues

We take security very seriously at Representable.org. Please send an email to team@representable.org with any security issues and we'll open a private issue request with your concerns. We aim to respond to all security issues in a timely manner.

Representable Contributors

Our core team of engineers is currently 6 members strong, though we've been supported by many others along the way. See more about our team and how we work at representable.org/about

Somya Arora
Kyle Barnes
Chukwuagoziem Uzoegwu
Jason Yuan
Anna Eaton
Izzy Zaller

Founders

Representable began as a final project for Princeton University course Advanced Programming Techniques, taught by Brian Kernighan. The original project team is:

Theodor Marcu
Lauren Johnston
Preeti Iyer
Somya Arora
Kyle Barnes

License

Representable is under the GPL-3.0 License.

Name		Name	Last commit message	Last commit date
.github		.github
bin		bin
docs		docs
main		main
representable		representable
representable_plus		representable_plus
scripts		scripts
.Python		.Python
.env.example		.env.example
.flake8		.flake8
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
.prettierignore		.prettierignore
.travis.yml		.travis.yml
Aptfile		Aptfile
Dockerfile		Dockerfile
LICENSE		LICENSE
Procfile		Procfile
README.md		README.md
SECURITY.md		SECURITY.md
dev_reqs.txt		dev_reqs.txt
docker-compose.yml		docker-compose.yml
gpl-v3.tmpl		gpl-v3.tmpl
manage.py		manage.py
models.png		models.png
new_models.png		new_models.png
package-lock.json		package-lock.json
pyproject.toml		pyproject.toml
pyvenv.cfg		pyvenv.cfg
representable.code-profile		representable.code-profile
requirements.txt		requirements.txt
requirements.txt.old		requirements.txt.old
runtime.txt		runtime.txt
state_abbrev.py		state_abbrev.py
translate.py		translate.py

Name		Name	Last commit message	Last commit date
.github		.github
bin		bin
docs		docs
main		main
representable		representable
representable_plus		representable_plus
scripts		scripts
.Python		.Python
.env.example		.env.example
.flake8		.flake8
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
.prettierignore		.prettierignore
.travis.yml		.travis.yml
Aptfile		Aptfile
Dockerfile		Dockerfile
LICENSE		LICENSE
Procfile		Procfile
README.md		README.md
SECURITY.md		SECURITY.md
dev_reqs.txt		dev_reqs.txt
docker-compose.yml		docker-compose.yml
gpl-v3.tmpl		gpl-v3.tmpl
manage.py		manage.py
models.png		models.png
new_models.png		new_models.png
package-lock.json		package-lock.json
pyproject.toml		pyproject.toml
pyvenv.cfg		pyvenv.cfg
representable.code-profile		representable.code-profile
requirements.txt		requirements.txt
requirements.txt.old		requirements.txt.old
runtime.txt		runtime.txt
state_abbrev.py		state_abbrev.py
translate.py		translate.py

Name		Name	Last commit message	Last commit date
.github		.github
bin		bin
docs		docs
main		main
representable		representable
representable_plus		representable_plus
scripts		scripts
.Python		.Python
.env.example		.env.example
.flake8		.flake8
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
.prettierignore		.prettierignore
.travis.yml		.travis.yml
Aptfile		Aptfile
Dockerfile		Dockerfile
LICENSE		LICENSE
Procfile		Procfile
README.md		README.md
SECURITY.md		SECURITY.md
dev_reqs.txt		dev_reqs.txt
docker-compose.yml		docker-compose.yml
gpl-v3.tmpl		gpl-v3.tmpl
manage.py		manage.py
models.png		models.png
new_models.png		new_models.png
package-lock.json		package-lock.json
pyproject.toml		pyproject.toml
pyvenv.cfg		pyvenv.cfg
representable.code-profile		representable.code-profile
requirements.txt		requirements.txt
requirements.txt.old		requirements.txt.old
runtime.txt		runtime.txt
state_abbrev.py		state_abbrev.py
translate.py		translate.py

Name		Name	Last commit message	Last commit date
.github		.github
bin		bin
docs		docs
main		main
representable		representable
representable_plus		representable_plus
scripts		scripts
.Python		.Python
.env.example		.env.example
.flake8		.flake8
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
.prettierignore		.prettierignore
.travis.yml		.travis.yml
Aptfile		Aptfile
Dockerfile		Dockerfile
LICENSE		LICENSE
Procfile		Procfile
README.md		README.md
SECURITY.md		SECURITY.md
dev_reqs.txt		dev_reqs.txt
docker-compose.yml		docker-compose.yml
gpl-v3.tmpl		gpl-v3.tmpl
manage.py		manage.py
models.png		models.png
new_models.png		new_models.png
package-lock.json		package-lock.json
pyproject.toml		pyproject.toml
pyvenv.cfg		pyvenv.cfg
representable.code-profile		representable.code-profile
requirements.txt		requirements.txt
requirements.txt.old		requirements.txt.old
runtime.txt		runtime.txt
state_abbrev.py		state_abbrev.py
translate.py		translate.py

Name		Name	Last commit message	Last commit date
.github		.github
bin		bin
docs		docs
main		main
representable		representable
representable_plus		representable_plus
scripts		scripts
.Python		.Python
.env.example		.env.example
.flake8		.flake8
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
.prettierignore		.prettierignore
.travis.yml		.travis.yml
Aptfile		Aptfile
Dockerfile		Dockerfile
LICENSE		LICENSE
Procfile		Procfile
README.md		README.md
SECURITY.md		SECURITY.md
dev_reqs.txt		dev_reqs.txt
docker-compose.yml		docker-compose.yml
gpl-v3.tmpl		gpl-v3.tmpl
manage.py		manage.py
models.png		models.png
new_models.png		new_models.png
package-lock.json		package-lock.json
pyproject.toml		pyproject.toml
pyvenv.cfg		pyvenv.cfg
representable.code-profile		representable.code-profile
requirements.txt		requirements.txt
requirements.txt.old		requirements.txt.old
runtime.txt		runtime.txt
state_abbrev.py		state_abbrev.py
translate.py		translate.py

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

Representable PA +

Documentation

Quick start

Tips

General Issue Reporting

Reporting Security Issues

Representable Contributors

Founders

License

About

Topics

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

Representable PA +

Documentation

Quick start

Tips

General Issue Reporting

Reporting Security Issues

Representable Contributors

Founders

License

About

Topics

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

Representable PA +

Documentation

Quick start

Tips

General Issue Reporting

Reporting Security Issues

Representable Contributors

Founders

License

About

Topics

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Uh oh!

Latest commit