Squeak! is a toolkit for fostering a community in-house. It helps make discussions, resources, and solutions more accessible to the right people.

Learn more at squeak.posthog.com and star us to follow along.

Want to try it without installing? There's a cloud version of Squeak! too.

Squeak! tools are built for React-based static sites, but many products work with existing docs, knowledge bases, or websites.

Visit the wiki for guides on:

1. Embeddable widget (JavaScript, React)
2. Admin portal
3. Integrations
4. Self-hosting
5. API
6. Local development

• Roadmap
• Feature request? Create an issue!

Squeak! was created by PostHog out of a need to better support our own customers and move conversations out of our Slack community. Squeak! is open source under MIT.

We use Prisma as our ORM. Prisma works by interpreting a schema file defined in prisma/schema.prisma and using a generated client. Prisma generates a strongly-typed client based on the schema file. The client is generated at runtime and not checked into version control. See the prisma docs about this. This means that the prisma client needs to be generated as part of any deployment process. As noted in the prisma docs, the prisma generate command is run as a postinstall hook when the prisma library is installed.

On deployment, the database needs to be migrated by running: npx prisma migrate deploy. See below for useful docs on production migrations:

• https://www.prisma.io/docs/concepts/components/prisma-migrate#production-and-testing-environments
• https://www.prisma.io/docs/guides/deployment/deploy-database-changes-with-prisma-migrate
• https://www.prisma.io/docs/reference/api-reference/command-reference#migrate-deploy

We use Sentry to capture errors, and we need to upload source maps to sentry and create a release in sentry. Currently this happens while building the docker image. Sentry automatically hooks into the yarn build process and uploads source maps and creates a release. This requires having a SENTRY_AUTH_TOKEN environment variable set to be picked up by the sentry-cli.

We handle this currently during docker builds via Github Actions. We pass in the SENTRY_AUTH_TOKEN as an build-arg to Docker from a github secret. See .github/docker-release.yml for that configuration.

This project uses superjson to automatically handle serialization issues, primarily with BigInt, which we use for certain IDs.