Guild.xyz interface

Open source interface for Guild.xyz -- a tool for platformless membership management.

• Website: guild.xyz
• Docs: docs.guild.xyz
• Twitter: @Guildxyz
• Discord: Guild.xyz

Key dependencies overview

• Framework
  • React with Next.js
• Styling:
  • Chakra UI
  • Phosphor icons
  • Framer motion
• State management:
  • SWR for fetching and caching
  • React Hook Form for form state
  • jotai for custom, simple global state
• Web3 stuff:
  • viem
  • wagmi for connection management
• Deployment:
  • Vercel
• Product analytics:
  • PostHog
• Error monitoring:
  • BugSnag

Development

Running the interface locally

1. npm i
2. npm run dev
3. If you don't have the WAAS_WEB_URL and WAAS_VIEM_URL variables defined in .env.local, you need to run node mockWaas.js after npm i. The Google login functionality won't be available in this case

Open http://localhost:3000 in your browser to see the result.

For Windows users

If you encounter the error ERR_OSSL_EVP_UNSUPPORTED you can do :

export NODE_OPTIONS=--openssl-legacy-provider
npm i --force
npm run dev

Getting secret environment variables (for core team members):

1. Get added to the team on Vercel
2. npm i vercel@latest -g
3. vercel link
4. vercel env pull .env.local

Code guidelines

• Always use design system values for styling when possible
• Follow the file naming and folder structure pattern of the repository

Committing

• Use Conventional Commits when applicable (recommended but not required)
• Always use present tense in commit messages
• Always review your changes before committing
• A pre-commit hook type checks the code base. If it fails but you want to commit a WIP anyway use --no-verify

PR flow

• Always create a draft PR right away when starting to work on a new branch
• Vercel creates a unique link for each commit and each branch (showing the latest version of the branch), which you can get from the deployment page. Share the branch link with the team if needed
• Always self-review changes in your PR before asking others. Refactor, clean up and add comments if needed. Repeat until there's no room for improvement that you see, or you've left a comment where there is
• If you consider it ready, mark it as ready for review and ask for a review, or merge it by yourself if you have the permission