gitcoinco / simplegrants.xyz

Web2 Quadratic Funding platform

SimpleGrants.xyz

Developing

npm install
cp .env.example .env
npm run dev

Testing

# Unit / Integration / Components (Vitest)
npm run test

# End-to-End (Playwright)
npm run test:e2e

# E2E codegen (launches a browser to record clicks)
npm run test:codegen

Stripe Webhooks

Simulate a successful checkout

stripe listen --forward-to localhost:3000/api/stripe/webhook

stripe trigger payment_intent.succeeded

Prisma Studio

npm run db:studio

simplegrants.xyz's Issues

devex: for required env variables.... add easy links to get them

> [email protected] dev
> next dev

❌ Invalid environment variables: {
  STRIPE_SECRET_KEY: [ 'Required' ],
  STRIPE_WEBHOOK_SECRET: [ 'Required' ],
  STRIPE_WEBHOOK_SECRET_CONNECT: [ 'Required' ],
  BLOB_READ_WRITE_TOKEN: [ 'Required' ],
  POSTGRES_PRISMA_URL: [ 'Required' ],
  POSTGRES_URL_NON_POOLING: [ 'Required' ],
  CLERK_SECRET_KEY: [ 'Required' ]

for each of these, itd be nice if the .env.example had a link to where i could get a valid env variable. the stripe one is obvious to me.. but th eothers are not. linnk me to the pages/instructions to generate them without thinking?

we should also denote in comments which env variables are required.. for easy setup.

changing site logo/brand

can we make it easy for ppl to whitelabel the site to their own brand?

im assuming many partners wont want to brand it 'simple grants'..

we should have a .md doc that tells ppl:

1. how to update the logo in the top left
2. how to update site name
3. how to update color scheme

add a "contact us" button on main page

it should be under "creat a round" and "create a grnat"

it should say "contact us" with text "contact the team behind simplegrants.xyz "

setup instructions

how do i get this runnning locally?

owocki@local /Users/owocki/Sites/simplegrants.xyz~ % npm run dev                                           (git)-[main] :


> [email protected] dev
> next dev

sh: next: command not found

is there a setup/install command?