18kimn/yale-detour

READ-ONLY MIRROR of the Yale Detour, a critical history and digital cartography project formerly known as the Yale Critical History Project.

The Yale Detour

The Yale Detour aims to tell alternative histories of Yale. We want to think about how Yale’s history as a colonial institution remains embedded in its architecture and landscape in the present-day, and to highlight sites where Yale students and New Haven residents have changed the course of the university’s history through remarkable moments of struggle.

It was adapted from an in-person tour developed by Esul Burton and Janis Jin. Work on the digital version was begun by Esul, Janis, and Collin Bentley, and is currently maintained by Resty Fufunan, Jose Garcia, Dora Guo, Nathan Kim, and Amy Kim.

Please see our wiki for more information!

yale-detour's Issues

carousel needs revamp

currently the carousel is built as a fairly large image, with a block of scrollable text below it. This is fine for the existing text but it poses some problems with the addition of new locations:

• the new locations have a lot more text, and each carousel item should accommodate that with more efficient use of room
• the detour zine is fairly creative and looks great aesthetically; ours should match that

add location from amy and jose's er&m class

update browserslist

there's an annoying warning that pops up saying we should update our browserslist specified by some package. too lazy to look it up right now or fix it even though it would be a one-liner

Add images to edst255 posts

keyboard navigation for sites

left and right keys to switch sites
pressing "h" or "page down" takes you to the beginning or something
etc

writing should be ~elevated ~

Currently writing for our first set of components comes out to about one paragraph a site, which is fine but doesn't match the length from amy/jose/et al's detour zine and also does not "point" to many new places for information.

Writing should be revamped to include:

• lots of citations
• just more content in general

cut down on writing and add footnotes

each post should be 2-3 paragraphs, and additional sources should be linked out through citation footnotes

update mapbox studio design

we currently have a pretty generic "urban base map" style that I threw together a few months back, but it doesn't convey the seriousness of the topic at hand. This needs an overhaul to a more black/red style

migrate to mui

and in the process fix #1

• switch out modal and nav components
• use mui grid instead of container/row/col
• change stylesheets into makestyles()

Remove simple: field from markdown yaml

It can be inferred from filename instead, and I'm pretty sure it's not used anywhere

add location from amy and jose's er&m class

render authors

so we can give people credit for their writing and work

General styling problem

Currently our styles are kind of tame or friendly; along the same lines as #4 we should update our aesthetics so that they communicate the seriousness of our topic

• darker color theme
• glitch effect for title / logo
• choose font again to be a very readable serif

Performance audit

Our Lighthouse score is pretty bad, especially our first contentful paint which clocks in at a massive 5.4 seconds.

There's likely a bottleneck somewhere, but in general we can boost this with:

• async loads for posts
• go "vanilla" React (attempt to eject from bootstrap), but I don't know if this is an actual issue
• switch to Leaflet from Mapbox and just link the Mapbox style
• use system fonts

general accessibility audit

there are some things, like alt text, that are obvious and can be fixed by us granted we have enough time. other things we just don't notice. we should fix those things too, so to do that it would be nice to have an a11y expert do an audit of our site.

change all flyTo()s into easeTo()s

the slowness and the rotation makes it kind of funky right now haha

local/prod views are different

dev version looks like this:

prod version looks like this:

find out what makes the prod version different and fix it so that the ovals are wide!

fix typeform component

we currently have a typeform component to create new locations, but it doesn't actually do anything or submit anywhere. we should fix that

TypeError: Cannot read properties of undefined (reading 'title')

On the edst255-migration branch, I introduced a bug by accident :0 clicking the 'next'/'right' button too much brings in the above error

Migrate to Leaflet

Leaflet is 38kb gzipped/minified vs Mapbox GL JS ~150Kb

Map should have zoom limit

Currently you can zoom out and pan infinitely, which doesn't make much sense. It should be limited!

fix the image carousel

this is a react-bootstrap error