manifold/web
Sinclair Chen f2764e9258
Remove keyboard accessibility for tooltips (#779)
Headless UI's Modal component autofocuses the first focusable item
inside it when opened. This is by design for accessibility reasons.
See https://headlessui.com/react/dialog#managing-initial-focus

Ironically this means we'll have to remove keyboard focus for tooltips
because this causes the tooltips to pop up unnecessarily for all users
whenever the dialog is opened. The alternative is managing focus
manually for several dialogs, which may not be possible as some of our
modals lack a sensible element to focus by default.
2022-08-18 18:54:09 -07:00
..
components Remove keyboard accessibility for tooltips (#779) 2022-08-18 18:54:09 -07:00
hooks Remove some dead code related to tags, categories, and old feed stuff (#765) 2022-08-18 15:46:11 -07:00
lib Remove some dead code related to tags, categories, and old feed stuff (#765) 2022-08-18 15:46:11 -07:00
pages Remove some dead code related to tags, categories, and old feed stuff (#765) 2022-08-18 15:46:11 -07:00
public Replace /markets with /home (#766) 2022-08-17 23:15:25 -07:00
.eslintrc.js Api fixes (#704) 2022-08-16 15:01:03 -07:00
.gitignore Run a ts type checker in parallel with nextjs dev process 2021-12-19 15:26:59 -06:00
.prettierignore Host Ida and Alex's MTG Guesser game (#656) 2022-07-20 16:57:51 -07:00
.yarnrc when adding package, don't put ^ before version (#645) 2022-07-13 15:14:06 -07:00
get-manalink-url.ts initial commit for manalinks UI improvements (#642) 2022-07-13 16:57:34 -05:00
next-env.d.ts upgrade nextjs version 2021-12-15 23:49:38 -06:00
next-sitemap.js Generate sitemap server-side 2022-03-24 09:52:13 -07:00
next.config.js redirect /about; more content in welcome email 2022-08-17 11:21:29 -05:00
package.json Api fixes (#704) 2022-08-16 15:01:03 -07:00
postcss.config.js Prettier: no semi, spaces 2, single quote, trailing comma 2021-12-02 17:49:46 -06:00
README.md A couple additions to help newbies out (#104) 2022-04-27 13:15:14 -07:00
tailwind.config.js noobify welcome demo (#699) 2022-07-30 02:50:03 -05:00
tsconfig.json Typescript project references take 2 (#586) 2022-06-27 13:32:24 -07:00

Manifold Markets web app

Getting started

To run the development server, install Yarn 1.x, and then in this directory:

  1. yarn to install all dependencies
  2. yarn dev:dev starts a development web server, pointing at the development database
  3. Your site will be available on http://localhost:3000

Check package.json for other command-line tasks. (e.g. yarn dev will point the development server at the prod database. yarn emulate will run against a local emulated database, if you are serving it via yarn serve from the functions/ package.)

Tech stack

Manifold's website uses Next.js, which is a React-based framework that handles concerns like routing, builds, and a development server. It's also integrated with Vercel, which is responsible for hosting the site and providing some other production functionality like serving the API. The application code is written exclusively in Typescript. Styling is done via CSS-in-JS in the React code and uses Tailwind CSS classes.

Building and deployment

Vercel's GitHub integration monitors the repository and automatically builds (next build) and deploys both the main branch (to production) and PR branches (to ephemeral staging servers that can be used for testing.)

Parts of the file structure that directly map to HTTP endpoints are organized specially per Next.js's prescriptions:

public/

These are static files that will be served by Next verbatim.

pages/

These are components that Next's router is aware of and interprets as page roots per their filename, e.g. the React component in pages/portfolio.tsx is rendered on the user portfolio page at /portfolio. You should look in here or in components/ to find any specific piece of UI you are interested in working on.

pages/api/

Modules under this route are specially interpreted by Next/Vercel as functions that will be hosted by Vercel. This is where the public Manifold HTTP API lives.

Contributing

Please format the code using Prettier; you can run yarn format to invoke it manually. It also runs by default as a pre-commit Git hook thanks to the pretty-quick package. You may wish to use some kind of fancy editor integration to format it in your editor.

Developer Experience TODOs

  • Prevent git pushing if there are Typescript errors?