Welcome to the NeoKingdom DAO dapp

This is the code for the NeoKingdom DAO dapp

Getting started

pnpm i
pnpm run dev

Get env variables locally

• install vercel CLI
• run vercel link
• set the name of the project you want the env (see here)
• run vercel env pull --environment=production|staging .env.local
• profit 💰

Note: if you want to change from i.e. teledisko to neokingdom, just re-run vercel link and choose dapp-neokingdom as project name.

Run a local Postgres instance

• Set POSTGRES_LOCAL=true in your .env file
• Run docker compose -f local-compose.yaml up
• Run npx drizzle-kit push

You can now run the app connected to your local database.

How to add a Subgraph query

• Create a new file inside the ./lib/graphql/subgraph/queries/ folder
• Copy the way other queries are structured to be able to generate TS types
• When the query is ready or after each update remember to run pnpm codegen:subgraph

If the schema on https://api.neokingdom.org/subgraphs/name/NeokingdomDAO/vigodarzere is not working - as the server is down - try with https://api2.neokingdom.org/subgraphs/name/NeokingdomDAO/vigodarzere. You can find in ./codegen-subgraph.ts

Feature flags

We use Hypertune to handle feature flags in our dapp. To update or add a new flag you need to be added to Hypertune by your teammates.

To be able to override feature flags locally using the Vercel Toolbar you need to:

• run pnpm i -g vercel@latest if not already installed
• run vercel link and connect it to our existing project

How to add or update a feature flag

• Open the Hypertune project on your browser and make your changes
• Save the changes to make them active
• Run pnpm featureflags:generate to generate the updated type definition

How to run e2e tests

You can run e2e tests with Playwright in two different ways. In both case remember to start the local server with pnpm dev.

The first time you should run pnpm e2e:init before running e2e tests. After that you can use one of the following options:

• With the CLI (faster): pnpm e2e
• With the UI (easier to debug): pnpm e2e:ui