- Node.js (v18 or higher) - The backbone of our project, make sure you have this installed.
- pnpm - Our trusty package manager, because who doesn't love faster installs?
- Postgres App - Our database of choice, because data needs a cozy home.
- Redis - The speedy in-memory data store, for when you need things done in a flash.
We harness the power of pnpm workspaces to keep our monorepo running smoother than a freshly buttered pancake.
Want to join the cool kids' club and access the repository on Pierre? Hit up Yoginth with your brilliant ideas—let's team up and create the web's next big thing!
git clone git@git.pierre.co:/repos/hey/hey.gitRocking a macOS? You can grab both with Homebrew, like a true brew master:
brew install nvm pnpmUse nvm to summon the magical version of Node.js you need:
nvm installTeleport yourself to the root of the repository and let pnpm sprinkle its dependency magic:
pnpm installChannel your inner wizard and conjure up a .env file from the .env.example template for every package and app that needs it. Don't forget to sprinkle in the necessary environment variables!
cp .env.example .envDon't forget to play copycat and repeat this .env file creation for every package and app that needs it. Consistency is key!
When all the stars align and everything is in place, kick off the application in development mode:
pnpm devReady to build the application? Just run this command:
pnpm buildWant to run tests while you're developing? Here's how you do it:
pnpm testWe use ts-prune to hunt down and eliminate unused exports and helpers lurking in our codebase. Just a heads-up: you'll need to run this task manually for each package and app. Happy pruning!
cd apps/web; npx ts-prune -i generated.tsTime to give our dependencies a makeover! We rely on the magical powers of pnpm to keep everything up-to-date and looking sharp.
script/clean-branches
script/update-dependenciesWe trust pnpm to keep our lock file fresh and fabulous!
script/clean-branches
script/update-lock-fileOur repositories are managed using Pierre. You can find our mirrored repository on GitHub here. Although we do not accept pull requests (PRs) on GitHub, we encourage you to open issues.
This command will whip up a new incremental branch based on your current branch. It's like a clone, but cooler!
Imagine you're on the feature/login branch, and you run the command below. Voilà! A shiny new branch called feature/login@2 will appear, like magic!
npx pierre@latest versionNeed to create a new branch with the latest changes and a sprinkle of your own magic? This command's got your back! Perfect for when you want to dazzle us with your PR changes.
We use Ripgrep to search for text in the codebase. It's like grep and ag had a baby, and that baby grew up to be a speed demon!
Install it via Homebrew:
brew install ripgrepSearch for text in the codebase:
rg "const Verified"In apps/web, we've got a bundle analyzer that spills the beans on the size and contents of our production bundles. It's like having X-ray vision for your code!
To generate this output, run:
cd apps/web
ANALYZE=true pnpm buildFire up this command to build the apps/web project and watch as three browser windows magically pop open, each showcasing bundle details for node, edge, and client bundles. The client bundle is the superhero for page performance, while all bundles play a vital role in development and build performance.
We kindly ask all contributors and team members to follow our Code of Conduct. Think of it as our community's golden rulebook - play nice and keep the good vibes flowing!
This project is open-sourced under the AGPL-3.0 license. For all the nitty-gritty details, check out the LICENSE file. It's a real page-turner!
We 💖 you to the moon and back! Your support is like a never-ending supply of coffee for our code. Thank you for making Hey the most awesome place in the universe!
🌸