ACCESS NYC provides a mobile-friendly front door for New Yorkers to screen for City, State, and Federal benefit and program eligibility as well as learn how to apply to programs and find local help.
ACCESS NYC is for benefits-seeking residents in NYC and accommodates residents...
- ... with low digital literacy
- ... with limited technology access, especially those who are mobile dependent
- ... who do not speak fluent English
- ... who have limited visual capabilities
ACCESS NYC and its underlying content are available as in this WordPress site repository and the NYC Open Data Portal. The ACCESS NYC eligibility screener is a single page web application powered by an API built on the Drools Business Rules Management System hosted on Amazon Web Services through the NYC Department of Information Technology and Telecommunications. Additional benefit program content is delivered by WordPress, an open-source content management system, and hosted on WP Engine. All benefit program information on ACCESS NYC is publicly available through the Benefits and Programs API on the City of New York’s Open Data portal.
The ACCESS NYC Design System utilizes patterns from the U.S. Web Design System, the Bourbon SASS Tool Set, and the Tailwind.css Utility Framework. These are configured, distributed, and documented in a NPM Package ACCESS NYC Patterns which can be installed in any project.
Learn more about ACCESS NYC at nyc.gov/opportunity.
- Virtualization (Docker, Virtualbox, or other)
- Node and NPM
NYCO WP Docker Boilerplate
PHP and WordPress plugin dependencies for WordPress core and the ACCESS NYC Theme are managed via Composer. Learn more about Composer it's website.
Node and NPM
This won't cover all of the options for standing up a WordPress site given all of the options available but it can be done with Docker for Mac and following the instructions in the NYCO WP Docker Boilerplate readme.
ACCESS NYC is hosted on WP Engine and updates to WordPress are managed by their platform. WordPress dependencies (plugins) are managed via WP Packagist and the WordPress Admin (if they aren't available on WP Packagist). They are packaged with the repository to be easily shipped to different environments.
There are three Must Use plugins that are specifically developed for this project. They include Drools Proxy, Send Me NYC, and Stat Collector.
ACCESS NYC Theme
Some functions remain in the main
functions.php, however, new modules are stored in the
/includes directory and are included in
functions.php at the bottom of the file.
The source for image, style, and script files live in the
src and are compiled to the
/assets directory. This is done with the Gulp task manager.
To get started with modifying the theme front-end, change directories to the
access theme and run
npm install (Node and NPM are required to do this). This will install all node dependencies (including Gulp!) in the same directory.
The NPM package comes with three scripts;
development- This runs the default Gulp task in development mode which watches and compiles files.
predeploy- This will run a one-off build task in production mode. This should be run before all deployments.
Each can be run via
npm run <script>. Once they run, they will fire up a BrowserSync instance to live test your code.
While not required, a
.env file is included in the theme to define the proxy URL for BrowserSync. Copy
.env.example to a new file and name it
.env. Change the
WP_DEV_URL value to what is set in the
The query parameter
/eligiblity?debug=1#step-8, and if the web inspector is open will pause the app before and after the screener form is submitted while outputting the data payload and response object respectively.
Source files for the site’s CSS is located in the theme
/src/scss directory. The SCSS files are processed, concatenated, and minfied by the gulp styles task. The stylesheet is broken up into several smaller partials. Refer to
scss/_all.scss to get a sense of overall stylesheet organization.
For more details on multilingual and screen reader accessibile utilities refer to the Stylesheet wiki page.
ACCESS NYC Patterns (Pre-release)
ACCESS NYC Patterns are available as a pre-release while we develop their documentation. It is a refactored package of the previous U.S. Web Design System and Bourbon SASS Tool Set integration with an additional CSS utility framework called Tailwind.css. ACCESS NYC Patterns are distributed as an NPM Package that can be installed into any project using NPM, Yarn, or CDN. Refer to the documentation for details.
gulp lint task with the ESLint Google's standards. It is transpiled, concatenated, and minified by the
gulp scripts task, using Babelify (Babel + Browserify).
PHP (in progress)
Editor Config (deprecated)
.editorconfig file is included in the theme to enforce some style settings for code editors that support it. See editorconfig.com for more information.
NYC Opportunity is the New York City Mayor's Office for Economic Opportunity. We are committed to sharing open source software that we use in our products. Feel free to ask questions and share feedback. Follow @nycopportunity on Github, Twitter, Facebook, and Instagram.