English · Français
Review websites and PDFs together. Share one link, place a point, keep the conversation in context.
Open source · Self-hosted · MIT licensed · English & French
Quick start · Features · Deployment · Documentation · Star on GitHub
Repère helps agencies, clients and teams review work without collecting screenshots and disconnected messages. Create a project, share its link, and invite people to comment exactly where something needs attention.
Reviewers sign in with a six-digit email code. Every comment keeps its author, page and position. Websites remain interactive in the reviewer's own browser, and PDFs have points attached to individual pages.
Repère is an independent, open-source alternative for the visual feedback use case popularized by Markup.io. It is not affiliated with Markup.io and includes no proprietary code or assets from it.
See the dashboard, PDF review and mobile layout
| What you can do | |
|---|---|
| Workspaces | Create spaces, switch between them and move projects while keeping feedback and shared links. |
| Your team | Invite people by email, follow pending invitations and manage workspace members. |
| Websites and PDFs | Add a URL or upload a private PDF up to 20 MiB. Search and filter your projects. |
| Point screenshots | Capture the page when placing a point, keep it with the comment, and open it at full size. |
| Project covers | Capture a private preview on first opening, upload your own cover, or restore the automatic image. No external API. |
| AI prompts | Workspace members can copy all open feedback, or a single comment, with its page context and replies. |
| One shared link | Invite reviewers who verify their email with a one-time code. No password to create. |
| Precise feedback | Attach a point to a website element and page, or to a position on a PDF page. |
| Natural navigation | Browse, select text, follow links and use the site's controls. Switch to commenting when you want to place a point. |
| Clear conversations | Reply, resolve, reopen and filter feedback. Authors stay attached to their comments. |
| Project controls | Rename, archive, restore and renew a sharing link. Archived conversations remain readable by workspace members. |
| English and French | Choose a language, or start with your browser's preference. Share the same project URL in either language. |
| Your infrastructure | Run Next.js, MySQL and the preview service with Docker. Store PDFs in a private volume. |
There are no plan tiers or per-reviewer charges in the code. Hosting and email delivery are your responsibility. Conversations refresh every eight seconds while the tab is visible. Project thumbnails are illustrations, not live screenshots.
Deploying on EasyPanel with an existing MySQL database? Follow the two-service guide: application on port 3000, preview on port 3001, and your existing database. The single-container option below is also available.
The synapsr/repere image runs the application, native preview service and MySQL 8.4 in one container. It generates and retains its secrets, initializes the database and applies migrations automatically. Docker is the only local runtime requirement.
Version 0.6.0 is available on Docker Hub for Linux AMD64 and ARM64. Both variants were started with integrated MySQL and their public manifests were checked anonymously after publication; see the verification record.
Create .env.docker with your SMTP provider's settings; sign-in codes require working email delivery:
APP_URL=http://localhost:8080
PREVIEW_BASE_URL=http://localhost:8080
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=replace-me
SMTP_PASSWORD=replace-me
SMTP_FROM=Repere <hello@example.com>
SMTP_SECURE=falsedocker run -d --name repere --restart unless-stopped \
-p 8080:8080 --stop-timeout 40 \
-v repere-data:/data \
--env-file .env.docker \
synapsr/repere:0.6.0Open localhost:8080. Keep /data mounted: it contains the database, PDFs, screenshots, covers and generated secrets. Pin a published version or digest for repeatable deployments. An external MySQL database is optional.
For EasyPanel, choose separate application and preview services with existing MySQL, or deploy this single image on port 8080.
- Open the application and enter your name and an email address.
- Enter the sign-in code received in your email inbox.
- Create a project from a website URL or PDF. Try the included interactive website or upload the two-page sample PDF.
- Explore the content, switch to commenting, click a detail and publish your feedback.
- Copy the sharing link. A reviewer can open it in another browser and sign in with their own email.
- Reply and resolve feedback in the conversation panel.
For separate services, hot reloading or a local Mailpit inbox, use the development stack. It requires Docker Compose v2 and Node.js 22.13+; Node.js 24 is recommended.
git clone https://github.com/Synapsr/Repere.git
cd Repere
node scripts/setup.mjsSetup builds the services, creates an ignored .env, chooses available ports and applies migrations. The default app is localhost:3000, the Mailpit inbox is localhost:8026, and the preview service uses port 3001. This development setup captures email locally. Existing configuration and volumes are preserved.
Stop the development stack without removing its data:
docker compose -f compose.yaml -f compose.dev.yaml downRepère serves the website through a reverse proxy on a temporary, isolated origin. A native iframe displays the site, and a small injected script tracks navigation and annotation points. The site's JavaScript runs in the reviewer's browser; JavaScript files retain their original bytes.
The application handles identity and conversations. The preview service handles website traffic. A verified message channel connects the two, while comments are saved only after an explicit action in the application.
flowchart LR
V[Reviewer] --> A[Next.js application]
A -->|Drizzle| DB[(MySQL)]
A --> PDF[(Private PDFs)]
A --> SMTP[Email delivery]
A -->|Temporary session| P[Preview proxy]
V --> I[Native iframe on isolated origin]
I <-->|Pages and resources| P
P <-->|Validated destination| W[Website]
I <-->|Navigation and points| A
Web anchors store the original URL, an element selector, a text excerpt and relative coordinates, with document coordinates as a fallback. PDF.js renders PDF pages locally, including the bundled decoding resources needed by scanned documents.
A different origin can affect website behavior. Repère adapts same-origin HTML/CSS URLs, DOM URL attributes, fetch, XHR, history and WebSockets, but does not guarantee compatibility with every website.
- A project reviews one origin. Initial redirects establish its canonical URL; links to another origin open separately.
- Third-party CORS, OAuth, anti-bot systems, domain-bound keys, service workers and scripts that depend on their original hostname may need additional work.
- Website cookies and storage belong to an isolated preview session. Existing logins on the original site are not imported. Browser cookie policies also affect sign-in inside a preview.
- Points cannot reach inside cross-origin frames or closed shadow roots. If the target element changes, a point may use its coordinate fallback.
- The narrow preview changes the available width; it does not emulate all phone hardware features.
- PDF pages use a canvas without a text selection/search layer. Encrypted or invalid documents show an error.
The preview service keeps sessions in memory and currently runs as one instance. Restarting it requires reopening previews; projects, PDFs and conversations remain persistent. Read the preview architecture for the exact behavior.
On EasyPanel with an existing database, start with the application and preview service guide. The single-container image and Compose installation are alternative deployment modes.
A public deployment needs:
- An HTTPS application domain.
- A wildcard HTTPS domain for preview sessions, for example
*.repere.dev, with the exactapp.repere.devapplication route taking priority. The apexrepere.devcan serve a separate website. - An SMTP service for sign-in codes.
- Backups of MySQL, PDF uploads, comment screenshots and configuration.
These deployment modes need one instance of the current preview service. Keep a single replica and stop the old instance before replacing a container that uses the integrated MySQL volume. Local tests do not validate your future DNS, certificates or SMTP provider.
| Layer | Technology |
|---|---|
| Application | Next.js 16 App Router, React 19, strict TypeScript |
| Database | MySQL 8.4, Drizzle ORM, versioned SQL migrations |
| Languages | next-intl, English and French |
| Identity | Email OTP, Nodemailer, server-side sessions |
| Website preview | Node.js, parse5, native DOM annotation bridge |
| Documents | PDF.js, private filesystem storage |
| UI | CSS, Lucide icons, locally bundled fonts |
| Deployment | Single Docker image, optional Compose, persistent storage and health checks |
| Verification | Vitest, Playwright, real MySQL and Mailpit |
Exact dependency versions are pinned in package.json and package-lock.json.
| Guide | Contents |
|---|---|
| EasyPanel with existing MySQL | Separate application and preview services, domains and settings |
| Docker image | One container, integrated or external MySQL, persistent data |
| Deployment | Production domains, SMTP, configuration and maintenance |
| Development and testing | Host development, real integration tests and browser checks |
| Preview architecture | Transport, cookies, annotation messages and compatibility |
| Backend | Identity, permissions, rate limits, persistence and uploads |
| API contracts | Routes, shared types and preview protocol |
| Verification record | What was actually checked, and the scope of that evidence |
| Security | Reporting a vulnerability and deployment boundaries |
| Contributing | Workflow, translations, migrations and pull requests |
The current focus is a complete, understandable point-and-comment workflow. Planned work includes:
- Audio feedback: recording, playback and optional Whisper transcription. The schema reserves attachment metadata, duration, transcription status and provider.
- Text suggestions: select a passage, propose a replacement and preview the change in the page. Original and suggested text have reserved fields.
- Comment notifications, exports, account deletion and retention controls.
- Finer workspace roles and permission controls.
- PDF text selection, document versions and additional attachments.
- More compatibility fixtures, S3 storage and distributed preview sessions.
These are future capabilities, not features exposed by the current API. See the changelog for released changes.
Bug reports, reproducible website compatibility cases, translations, documentation and focused pull requests are welcome. Start with CONTRIBUTING.md. Report vulnerabilities through the private route described in SECURITY.md.
Repère is licensed under MIT, including commercial use and modification. Keep the required license notices when redistributing it. Fonts, icons and PDF resources retain their own licenses; see THIRD_PARTY_NOTICES.md.