Files
tool-evaluator/docs/handbook/getting-started.en.md
T
opencode 3de59ccaaf
Build & Push Docker Image / build (push) Successful in 2m33s
feat(i18n): full app + docs localization (de/en)
- translate remaining pages/components (admin, analytics, redundancy,
  trash, compare, browse, watchlist, admin tools tab, category combobox,
  theme toggle, tool preview card, tool-new/edit) to t() calls
- locales: 453 keys each, parity verified
- docs: bilingual handbook + release notes via *.en.md variants,
  language-aware docs.tsx (markdown paths, nav titles, search index),
  LanguageSwitcher in docs header
- generate-docs: emit per-locale handbook/release/search output,
  localized index.json fields (fileEn/titleEn), en-aware snapshots
2026-08-04 08:35:05 +02:00

1.8 KiB
Raw Blame History

title, order
title order
Getting Started 2

Getting Started

This page guides you through the most important workflows in toolr — from your first visit to creating and rating a tool.

1. Sign in

Most actions (create a tool, rate, watchlist, compare) require an account. Click Sign in in the bottom left corner. Depending on the instance configuration you have two options:

  • Local accounts: username + password. Access is created by an admin (see Administration).
  • OIDC (SSO): sign in with the configured identity provider (e.g. Keycloak).

Which mode is active is shown by the GET /auth/mode endpoint. Details can be found in the Sign in & account section.

2. Find tools

Open the Browse tools section:

  • Search — full-text search across name & description (shortcut /).
  • Filter — by category, tags, features and minimum rating (minRating).
  • Sort — by newest, top-rated, most rated, name (ascending/descending) or last update.

All options in detail: Find & browse tools.

3. Create a tool

Go to Add tool and fill in the form. Details for each field can be found in the Create a tool section and in the field reference.

4. Rate

On the detail page of a tool you can submit usefulness and usability (15 each) and optionally leave a comment. Your rating is immediately reflected in the statistics. See Rating.

5. Further reading