open.source/manifold
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Manifold Markets: A market for every question
1,817 Commits 88 Branches 0 Tags 33 MiB
TypeScript 82.1%
HTML 16.1%
JavaScript 0.8%
Python 0.7%
CSS 0.3%
6c484b8755
Go to file
Austin Chen 6c484b8755 Add new indices
2022-07-01 11:55:14 -07:00
.github Typescript project references take 2 (#586) 2022-06-27 13:32:24 -07:00
.vscode add tailwind to recommended vscode extensions 2022-06-23 14:25:55 -05:00
common Scaffold Atlas2 instance 2022-07-01 11:01:53 -07:00
docs Make the resolve API docs not obviously wrong (#604) 2022-06-30 15:25:32 -07:00
functions Filter for ian's deleted users 2022-07-01 08:29:12 -06:00
og-image Threaded free response comments & general comments sections (#121) 2022-05-03 14:38:40 -06:00
web Add new indices 2022-07-01 11:55:14 -07:00
.firebaserc Allow admins to see private-users info 2022-01-24 00:48:10 -06:00
.gitignore add tailwind to recommended vscode extensions 2022-06-23 14:25:55 -05:00
.prettierrc move prettier config to top level 2022-01-10 17:44:42 -06:00
firebase.json Typescript project references take 2 (#586) 2022-06-27 13:32:24 -07:00
firestore.indexes.json Manalink: Send mana to anyone via link (#114) 2022-06-23 01:07:52 -07:00
firestore.rules Referrals (#592) 2022-07-01 07:47:19 -06:00
LICENSE.md Choose MIT license 2022-04-02 12:01:23 -07:00
package.json Reorganize verify scripts (#589) 2022-06-28 12:46:25 -07:00
README.md Mention /docs package in README 2022-05-31 15:16:18 -07:00
yarn.lock Prevent duplicate Free Response answers (#581) 2022-06-25 16:18:49 -07:00

README.md

Manifold Markets

This monorepo has basically everything involved in running and operating Manifold.

Getting started

  1. Make sure you have Yarn 1.x
  2. $ cd web
  3. $ yarn
  4. $ yarn dev:dev
  5. Your site will be available on http://localhost:3000

See web/README.md for more details on hacking on the web client.

General architecture

Manifold's public API and web app are hosted by Vercel. In general, the web app runs as much as possible on the client; we follow a JAMStack architecture. All data is stored in Firebase's database, Cloud Firestore. This is directly accessed by the client for most data access operations.

Operations with complicated contracts (e.g. buying shares) are provided in a separate HTTP API using Firebase's Cloud Functions. Those are deployed separately from the Vercel website; see functions/README.md for more details.

Directory overview

  • web/: UI and business logic for the client. Where most of the site lives. The public API endpoints are also in here.

  • functions/: Firebase cloud functions, for secure work (e.g. balances, Stripe payments, emails). Also contains in functions/src/scripts/ some Typescript scripts that do ad hoc CLI interaction with Firebase.

  • common/: Typescript library code shared between web/ & functions/. If you want to look at how the market math works, most of that's in here (it gets called from the placeBet and sellBet endpoints in functions/.) Also contains in common/envs configuration for the different environments (i.e. prod, dev, Manifold for Teams instances.)

  • og-image/: The OpenGraph image generator; creates the preview images shown on Twitter/social media.

  • docs/: Manifold's public documentation that lives at https://docs.manifold.markets.

Contributing

Since we are just now open-sourcing things, we will see how things go. Feel free to open issues, submit PRs, and chat about the process on Discord. We would prefer small PRs that we can effectively evaluate and review -- maybe check in with us first if you are thinking to work on a big change.

By contributing to this codebase, you are agreeing to the terms of the Manifold CLA.

If you need additional access to any infrastructure in order to work on something (e.g. Vercel, Firebase) let us know about that on Discord as well.