No description
  • TypeScript 98.1%
  • HTML 1.2%
  • JavaScript 0.4%
  • CSS 0.2%
Find a file
Eason c21910b9e9
Merge pull request #313 from usertour/staging
Add PostgreSQL backup script and improve configuration handling
2026-03-28 10:56:42 +08:00
.github/workflows chore: improve Docker image workflow with additional logging 2025-07-05 17:47:00 +08:00
.husky chore: configure lint-staged for Biome checks 2025-02-13 17:20:02 +08:00
apps refactor(backup): enhance environment variable handling and improve config loading 2026-03-28 10:23:34 +08:00
assets chore(sdk): update version to 0.4.8 and refactor rules evaluation 2025-12-16 12:13:25 +08:00
nginx fix(nginx): update caching headers for entry files to ensure fresh deployments 2026-03-23 19:27:07 +08:00
packages feat(rules): add zIndex handling for dropdown menus in EventCount, EventTime, and EventScope selectors 2026-03-23 11:16:54 +08:00
scripts chore(dependencies): update .gitignore and Dockerfile for improved build process 2026-01-13 16:37:10 +08:00
.dockerignore chore(dependencies): update .gitignore and Dockerfile for improved build process 2026-01-13 16:37:10 +08:00
.env.example feat: enable Redis TLS using environment variable 2026-03-09 10:04:29 -05:00
.gitignore chore(dependencies): update .gitignore and Dockerfile for improved build process 2026-01-13 16:37:10 +08:00
.npmrc feat: open source 2025-01-24 18:42:53 +08:00
biome.json feat(packages): Adapt to Biome and Husky syntax checks 2025-02-13 16:48:13 +08:00
CONTRIBUTING.md feat: Add Google Tag Manager integration with Next.js third-parties 2025-02-23 20:10:13 +08:00
docker-compose.yml chore(docker): update Dockerfile and docker-compose.yml for improved compatibility 2025-12-07 21:58:18 +08:00
Dockerfile feat(db): add PostgreSQL backup script and update Dockerfile 2026-03-27 18:30:09 +08:00
LICENSE feat(license): restructure licensing to MIT and remove AGPL references 2026-03-19 17:27:05 +08:00
LICENSE.enterprise Update licensing information and add enterprise license 2026-03-19 17:05:05 +08:00
package.json feat(license): restructure licensing to MIT and remove AGPL references 2026-03-19 17:27:05 +08:00
pnpm-lock.yaml feat: add UI package dependency and enhance project owner selection with improved search functionality 2026-03-16 11:51:56 +08:00
pnpm-workspace.yaml refactor(packages): restructure shared packages and update dependencies for improved organization 2026-01-22 18:38:42 +08:00
postcss.config.cjs feat(packages): Adapt to Biome and Husky syntax checks 2025-02-13 16:47:51 +08:00
README.md feat(license): restructure licensing to MIT and remove AGPL references 2026-03-19 17:27:05 +08:00
tsconfig.json chore(dependencies): update .gitignore and Dockerfile for improved build process 2026-01-13 16:37:10 +08:00
turbo.json chore(scripts): update build and dev scripts for @usertour/helpers and @usertour/types 2026-01-14 10:46:38 +08:00

Usertour

usertour logo

Usertour: An alternative to: Appcues, Userpilot, Userflow, Userguiding, Chameleon , Etc...

Usertour is an open-source user onboarding platform. It allows you to create in-app product tours, checklists, and surveys in minutes—effortlessly and with full control.

Website | Documentation | Blog | Twitter | Discord

Static Badge Static Badge Discord Chat Static Badge

Quick Start

Self-deploy with Docker

Deploy your own feature-rich, unlimited version of Usertour using Docker.

To start deployment:

cp .env.example .env # make sure all required envs are properly set
docker compose up -d

Visit http://localhost:8011 to start using Usertour.

View details in Self-hosting.

One Click Deployment

Deploy on Railway

Local Development

View details in CONTRIBUTING.

Features

Usertour makes it easy to design in-app product tours, checklists, launchers, and surveys, enabling anyone to craft effective onboarding experiences. Our team is dedicated to consistently improving Usertour with frequent updates that include new features, bug fixes, and performance enhancements.

Easy Onboarding: Build Flows Fast with Simple Integration and Smart Targeting

  • 🌐 Compatible with all frameworks: If your app runs in a browser, it seamlessly integrates with Usertour.
  • 📄 Supports multi-page apps: Whether it's a single-page application or spans across multiple pages, Usertour fits perfectly.
  • 🎯 Advanced user targeting: Define custom user attributes and track events to segment and engage your audience effectively.

Built for professional workflows with version control and environments

  • 🛠️ Multiple environments supported: Manage environments like Production and Staging within a single Usertour account.
  • 🔄 Version tracking: Monitor every change in your flows, including who made adjustments and when.

Fully customizable appearance

  • 🎨 Tailor your design: Adjust text, button colors, font family, and size to match your branding.
  • 🖌️ Support for multiple themes: Create unique themes for different flows, offering flexibility for varied use cases.

Gain actionable insights with powerful analytics

  • 📊 Performance metrics: Track the effectiveness of your flows with detailed data on views and completion rates.
  • 🚨 Identify problem areas: Pinpoint steps causing user confusion or drop-offs and address the issues seamlessly.

How to Use?

  • Cloud
    • We've deployed a Usertour Cloud version that allows zero-configuration usage, offering all capabilities of the self-hosted version. Visit https://www.usertour.io/ to get started.
  • Self-hosting Usertour Community Edition
    • Get started quickly with our Self-hosting Guide to run Usertour in your environment. For more detailed references and in-depth instructions, please refer to our documentation.
  • Usertour for enterprise / organizations

Contributing Guidelines

Bug Reports Feature Requests Issues/Discussions Usertour Community
Create Bug Report Submit Feature Request View GitHub Discussions Visit Usertour Community
Something isn't working as expected Ideas for new features or improvements Discuss and raise questions A place to ask questions, learn, and connect with others

Calling all developers, testers, tech writers and more! Contributions of all types are more than welcome, please feel free to browse our GitHub issues to show us what you can do.

For bug reports, feature requests, and other suggestions, you can also create a new issue and choose the most appropriate template to provide feedback.

If you have any questions, feel free to reach out to us. One of the best places to get more information and learn is the Usertour Community, where you can connect with other like-minded individuals.

Community and Contact

  • GitHub Discussion: Best for sharing feedback and asking questions.
  • GitHub Issues: Best for reporting bugs and suggesting features when using Usertour. Please refer to our contribution guidelines.
  • Discord: Best for sharing your applications and interacting with the community.
  • X(Twitter): Best for sharing your applications and staying connected with the community.

Security Issues

To protect your privacy, please avoid posting security-related issues on GitHub. Instead, send your questions to support@usertour.io, and we will provide you with a more detailed response.

Credits

Some icons are provided by Remix Icon (https://remixicon.com), licensed under the Apache License.

License

Community code is licensed under the MIT license. See LICENSE.

Enterprise-licensed code for self-hosted Business and Enterprise plans is governed by LICENSE.enterprise.