An open source NFT marketplace built on Reservoir.
Learn more about v2 of the Reservoir Market.
Reservoir Market is an open source marketplace that enables communities to easily launch their own NFT marketplace, accessing instant liquidity aggregated from other major marketplaces.
The marketplace supports 3 different modes:
- Single collection (e.g. Crypto Coven)
- Multi collection community (e.g. BAYC)
- All collections (example)
With each deployment, communities are given full control over their marketplace from designing their look and feel to setting their own marketplace fees.
- Install Node.js and NPM
- Install Yarn
- Request free Reservoir API key
Fork this repo and follow these instructions to install dependancies.
With yarn:
$ yarn installWith NPM:
$ npm installReservoir Market is built to be fully configurable using environment variables. To preview your configuration locally you can copy the values you want to use from env.development or env.production into a new file called .env.local.
Note: Environment variables can also be added during deployment via deployment platforms like vercel.
Required Configuration
| Environment Variable | Required | Description | Example |
|---|---|---|---|
| NEXT_PUBLIC_RESERVOIR_API_BASE | true |
The Reservoir API base URL. Available on Mainnet, Rinkeby, Goerli, and Optimism. | https://api-rinkeby.reservoir.tools/ https://api.reservoir.tools/ |
| NEXT_PUBLIC_CHAIN_ID | true |
The Ethereum network to be used. 1 for Etherem Mainnet and 4 for Rinkeby Testnet, etc. | 1 4 |
| NEXT_PUBLIC_PROXY_API_BASE | true |
The proxy API used to pass the Reservoir API key without exposing it to the client. | /api/reservoir |
| NEXT_PUBLIC_RESERVOIR_API_KEY | true |
Reservoir API key provided by the Reservoir Protocol. Get your own API key. | 123e4567-e89b-12d3-a456-426614174000 |
| NEXT_PUBLIC_ALCHEMY_ID | true |
Alchemy API key required for buying items on mobile. Get your own API key here. | 123e4567-e89b-12d3-a456-426614174000 |
General Configuration
| Environment Variable | Required | Description | Example |
|---|---|---|---|
| NEXT_PUBLIC_SOURCE_ID | false |
DEPRECATED: The source ID used to attribute listings and offers from your marketplace. | Reservoir Market |
| NEXT_PUBLIC_SOURCE_DOMAIN | false |
The source ID used to attribute listings and offers from your marketplace. Must be in a domain format. | reservoir.market |
| NEXT_PUBLIC_SOURCE_NAME | false |
The source name used to attribute listings and offers from your marketplace, falls back to the domain. | Reservoir Market |
| NEXT_PUBLIC_ORDER_KIND | false |
The order kind to be used when listing or making offers on your marketplace. Default will use seaport if not set. |
zeroex-v4. wyvern-v2.3, seaport |
| NEXT_PUBLIC_FEE_BPS | false |
The marketplace fee that will be earned from native listings and offers on your marketplace. Configured as <glossary:bps>. | 100 |
| NEXT_PUBLIC_FEE_RECIPIENT | false |
The address that will receive marketplace fee. | 0xF296178d553C8Ec21A2fBD2c5dDa8CA9ac905A00 |
| NEXT_PUBLIC_COLLECTION | false |
Use this to configure a single collection marketplace or set the default collection for your community marketplace. | 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63 |
| NEXT_PUBLIC_COLLECTION_SET_ID | false |
Use this to configure a community marketplace. Generate your collection set ID here. | f566ba09c14f56aedeed3f77e3ae7f5ff28b9177714d3827a87b7a182f8f90ff |
| NEXT_PUBLIC_COMMUNITY | false |
Use this to configure a community marketplace. Note: Community IDs are only available for certain communities. | artblocks |
| NEXT_PUBLIC_REDIRECT_HOMEPAGE | false |
If enabled, homepage will automatically redirect to collection page set in NEXT_PUBLIC_COLLECTION. | true |
| NEXT_PUBLIC_EXTERNAL_LINKS | false |
External links to be displayed in the top navigation bar. | Blog::<<<<https://blog.com,Docs::https://docs.com>>>> |
| NEXT_PUBLIC_COLLECTION_DESCRIPTIONS | false |
Customize descriptions on a per collection basis. | 0xb74bf94049d2c01f8805b8b15db0909168cabf46::test description,0xc751c84678d8e229e361f9b04c080256516f4a0a::another description |
| NEXT_PUBLIC_NAVBAR_LOGO_LINK | false |
Customize the marketplace navbar logo's link. | https://blog.com |
| NEXT_PUBLIC_DEFAULT_TO_SEARCH | false |
If enabled, search bar will be displayed instead of collection switcher. | true |
| NEXT_PUBLIC_LISTING_CURRENCIES | false |
Customize which currency users can list in. | [{"symbol": "ETH", "decimals": 18, "contract": "0x0000000000000000000000000000000000000000"},{"symbol": "USDC", "decimals": 6, "contract": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}] |
Design Configuration
| Environment Variable | Required | Description | Example |
|---|---|---|---|
| NEXT_PUBLIC_NAVBAR_LOGO | false |
The logo of your marketplace that appears on mobile. | https://www.reservoir.market/reservoir.svg |
| NEXT_PUBLIC_DESKTOP_NAVBAR_LOGO | false |
The logo of your marketplace that appears on desktop. | https://www.reservoir.market/reservoir-desktop.svg |
| NEXT_PUBLIC_FAVICON | false |
The favicon for your marketplace. | https://www.reservoir.market/reservoir.svg |
| NEXT_PUBLIC_SOURCE_ICON | false |
The icon that appears on native listings. | https://www.reservoir.market/reservoir.svg |
| NEXT_PUBLIC_DISABLE_POWERED_BY_RESERVOIR | false |
Use this to disable the Powered by Reservoir tag on modals. | true |
| NEXT_PUBLIC_DARK_MODE | false |
Use this to enable dark mode theme. | true |
| NEXT_PUBLIC_THEME_SWITCHING_ENABLED | false |
Use this to allow users to toggle between the dark and light theme. If NEXT_PUBLIC_DARK_MODE is enabled then that will be the default theme selected. | true |
| NEXT_PUBLIC_PRIMARY_COLOR | false |
Use this to select your primary color. | default, red, orange, lime, green, blue |
| NEXT_PUBLIC_FONT_FAMILY | false |
Primary sans font used in your marketplace. | Inter, Montserrat, Open Sans, Playfair Display, Roboto, Druk, Nunito Sans, Lucida Grande, Gazpacho, Frank Ruh Libre, Chalkboard, Gothicus Roman, Styrene B Black, Montserrat Uppercase Bold Italic |
| NEXT_PUBLIC_BODY_FONT_FAMILY | false |
Secondary font family used in your marketplace. | Inter, Montserrat, Open Sans, Playfair Display, Roboto, Druk, Nunito Sans, Lucida Grande, Gazpacho, Frank Ruh Libre, Chalkboard, Gothicus Roman, Styrene B Black, Montserrat Uppercase Bold Italic |
| NEXT_PUBLIC_FONT_URLS | false |
Use in conjunction with NEXT_PUBLIC_FONT_FAMILY and NEXT_PUBLIC_BODY_FONT_FAMILY to pull in a remote font, using services like google fonts, adobe fonts etc. | https://fonts.googleapis.com/css2?family=Blaka&display=swap,https://fonts.googleapis.com/css2?family=Bebas+Neue&display=swap |
| NEXT_PUBLIC_BANNER_IMAGE | false |
The background banner image used on collection pages. If not set this will use the default collection banner. | https://www.reservoir.market/banner.png |
| NEXT_PUBLIC_DISABLE_COLLECTION_BG | false |
Use this to hide the background banners on collection pages. | true |
| NEXT_PUBLIC_TAGLINE | false |
A tagline to be displayed in the homepage. Only available if NEXT_PUBLIC_COLLECTION and NEXT_PUBLIC_COMMUNITY are unset. | Buy, sell and collect NFTs! |
| NEXT_PUBLIC_FOOTER_ENABLED | false |
If enabled, a footer will be displayed on the homepage and the list of trending collections will be capped at 100. | true |
SEO Configuration
| Environment Variable | Required | Description | Example |
|---|---|---|---|
| NEXT_PUBLIC_META_TITLE | false |
The text used in the <title> tag. | Reservoir Market | Open Source NFT Marketplace |
| NEXT_PUBLIC_META_DESCRIPTION | false |
The text used in the meta description | Reservoir Market is an open source NFT marketplace built with Reservoir. |
| NEXT_PUBLIC_META_OG_IMAGE | false |
The image used in the meta og images . | https://www.reservoir.market/og.png |
Once you have your setup ready, run:
With yarn:
$ yarn dev
With npm:
$ npm run dev
This is a Next.js app that can be easily deployed using Vercel. For more information on how to deploy your Github repository with Vercel visit their docs.
If you'd like to contribute please follow the guidelines.
Twitter: @reservoir0x Project Link: Reservoir