Repository files navigation

A mobile friendly, multi-lingual web app that informs NYC residents aboutRent Stabilization by simplifying the process of how to find out if their apartment may be rent stabilized, if they are paying too much rent, and what to do about it.

See it in action atamirentstabilized.com.

Requires familiarity with the Command Line Interface, as well as installations of NodeJS v16.13.2 and Yarn ~v1.22.

Note it is recommended to useNode Version Manager (nvm) to switch between different NodeJS versions in a shell.

Note that the following commands assume to be run from the./app directory.

First be sure to install the required 3rd party dependencies:

yarn install

To start have Webpack watch for changes and serve the site using Webpack Dev Server:

yarn start

To create a production optimized build (will output assets to theapp/dist directory):

yarn prod

To run the tests in watch mode (highly recommended during development!):

yarn test:watch

To debug Webpack build issues, create a "debug" build by doing:

yarn webpack:debug

To serve the assets of the production build do:

yarn start:prod

Thehandlebars-loader Webpack loader handles the.hbs file extension so Webpack won't complain. It will automatically look for any Handlebars partials inapp/src/hbs_partials and helpers inapp/src/hbs_helpers.

Note that any newly added Handlebars partials will need to be registered with Jest in order for the unit tests not to break. Seesrc/setupJest.js for how this is done.

The app uses Handlebars.JS for translating content between three supported languages: English, Spanish, and Chinese.Any changes made to any of the written content in any of the HTML pages will need to be reflected in the corresponding locales JSON and potentially the Handlebars template files.

These files are located as follows:

• app/public/locales: JSON files for locales. The naming convention used is[page name]-[language code].json.
• app/src/hbs_templates: Handlebars template files that correspond to the websites HTML pages

Note that in both sets of filesmain maps toindex.html

Additionally, all supported languages are specified inapp/src/constants/locales.js.

Adding a new language translation will require:

1. Newlocale JSON files for each corresponding HTML page
2. Updating the constantsLANG andIN_LANG inapp/src/constants/locales.js
3. Updating the UI to display the new language option. The corresponding UI files are:
   • The Handlebarslanguage_toggle partial
   • The ComponentslanguageToggle.js andlanguageToggleButton.js inapp/src/components.

If many languages are to be supported in the future, then a dropdown / select menu may be more appropriate than individual language toggle buttons.

Note that currently "right to left" languages are not supported in the UI.

See thedata/ directory for a Makefile and Docker container configurations for generating the app's data.

The processed data is hosted andpublicly available for download on CARTO.

• Big thanks toCaroline Woolard for suggesting the idea to me.

• Jue Yang designed the awesome building graphics which informed the overall redesign of version 2 of the site.

• Eric Brelsford andBetaNYC provided motivational and technical support.

• Radish Lab contributed the design mockups for version 2.

• John Krauss provided data for NYC properties that should have rent-stabilized apartments due to receiving tax exemptions from state programs such as 421a. (You can learn more on the the repo fornyc-stabilization-unit-counts).

Forked fromChrysto's PenFullscreen slides with TweenLite, CSSPlugin and ScrollToPlugin.

APen byCaptain Anonymous onCodePen.

License.

Creative Commons Attribution-NonCommercial(CC BY-NC)

In other words:Not For Profit!