Documentation · Current workspace

Everything you need to use and understand Ergastírio.

A complete guide to the workshop, its tools, privacy model, architecture, design language, and development workflow.

01 · Introduction

A workshop, not a product suite.

Ergastírio (Εργαστήριο) means workshop. It is a collection of focused utilities that solve one job well, share one visual system, and avoid unnecessary accounts, subscriptions, and data collection.

05
visible tools
00
tracking cookies
MIT
license
02 · Getting started

Use the tools directly. No setup required.

Open a tool from the hub or navigate directly to its route. Every tool works without an account and remembers lightweight preferences in your browser.

01

Choose a tool

Start from the hub or open a direct route.

02

Work privately

Analyze a URL, generate a QR, clean a link, process PDFs, or inspect images.

03

Verify and export

Review the result, confirm the state, then download or save the output.

/          Ergastírio hub
/argus     Website intelligence
/kyklos    QR code generator
/papyrus   PDF workspace
/katharos  Tracking-link cleaner
/eikon     Image metadata workspace
/docs      Complete documentation
03 · Argus

Website intelligence with actionable fixes.

Argus analyzes a public webpage, produces an overall score, groups findings by category and priority, then explains why each issue matters and how to fix it.

01

Technical SEO

Titles, descriptions, canonical URLs, headings, robots, sitemap signals, and social metadata.

02

Performance

Markup heuristics for render blocking, image optimization, Core Web Vitals risks, and delivery quality.

03

Accessibility

Alt text, form labels, semantic structure, heading order, ARIA usage, and interaction concerns.

04

Security

HTTPS and response header checks including CSP, HSTS, frame protection, MIME protection, and referrer policy.

05

AI readiness

Schema, semantic structure, summaries, question headings, lists, tables, and entity clarity.

How to use
  1. 1. Enter a complete public URL.
  2. 2. Wait while the server proxy fetches the page.
  3. 3. Review the score and category breakdown.
  4. 4. Open an issue to see its explanation and fix.
  5. 5. Re-analyze after applying changes.
Important limits
  • • The page must be publicly reachable.
  • • Private IPs and localhost are blocked for security.
  • • Some hosts may block automated requests.
  • • Results are guidance, not a replacement for a full lab audit.
04 · Kýklos

Permanent QR codes generated in your browser.

Kýklos creates QR codes locally. The code itself has no expiry because it directly stores the provided content rather than depending on a redirect service.

URL and text QR codes
Foreground/background colors
Size and margin controls
Error correction
PNG/SVG export
Local generation
No expiry
No cookies
Recommended workflow

Enter the destination, choose contrast-safe colors, select the required size and error-correction level, test the preview with a phone, then export PNG for general use or SVG for print and scalable artwork.

05 · Papyrus

Shape PDF pages privately in the browser.

Papyrus renders PDF pages locally, then gives you a workspace for reordering, rotating, removing, extracting, splitting, and merging pages.

PDF to PNG/JPG conversion
Drag-and-drop upload
Page reorder and drag sorting
Rotate and remove pages
Split and merge workflows
Bulk extraction as ZIP
Client-side rendering
No file upload for browser workflows
Workflow

Drop a PDF, wait for the local page render to complete, drag pages into the right order, make any page-level changes, then extract individual images or download the complete result.

06 · Katharós

Clean shared links before they leave your hands.

Katharós removes recognized tracking parameters such as UTM values and click IDs from a URL. It does not fetch or inspect the page behind the link.

Tracking parameter detection
UTM and click-ID cleanup
Original link preserved locally
Copy cleaned URL
No page inspection
No link upload
Boundary

Paste a complete URL, clean it locally, review the result, and copy the shareable version. The original URL remains in the current browser session.

07 · Eikón

Inspect and remove image metadata privately.

Eikón reads available image metadata in the browser, shows the fields it can find, re-encodes the image, and verifies the exported copy. Bulk exports are packaged as a ZIP.

JPEG EXIF inspection
Camera and GPS field display
Metadata removal through re-encoding
Bulk image processing
ZIP export
Save-location picker where supported
Custom metadata report
Client-side processing
Verification

After export, Eikón reads the generated file again and reports the metadata fields found before and after processing. This makes the privacy result inspectable rather than implied.

08 · Privacy & data

Local by default, transparent when a server is required.

The tools avoid accounts, cookies, and behavioral tracking. Browser storage is only used to preserve preferences and useful local history.

ToolProcessingStored
ArgusServer proxy + client analysisRecent reports in localStorage
KýklosClient-sidePreferences only
PapyrusClient-side PDF renderingCurrent session only
KatharósClient-side URL cleanupTheme only
EikónClient-side image processingTheme only
DocsStatic client pageTheme only

Note: the Ergastírio site uses Umami, a cookieless and privacy-respecting analytics service, for aggregate visit counts only. Papyrus, Kýklos, Katharós, and Eikón keep working data in the browser; Argus is the exception because its public-page analysis uses the server proxy described above.

09 · Architecture

A focused Next.js application.

The project uses the App Router, TypeScript, Tailwind CSS, Motion, Lucide icons, and shared controls such as custom menus and animated toasts. Each visible tool has a direct route and keeps its domain logic close to its UI.

app/
├── page.tsx                # Ergastírio hub
├── docs/page.tsx           # Documentation
├── argus/page.tsx          # Website intelligence
├── api/argus/analyze/      # Server-side page proxy
├── kyklos/page.tsx         # QR generator
├── papyrus/page.tsx        # PDF workspace
├── katharos/page.tsx       # Tracking-link cleaner
└── eikon/page.tsx          # Image metadata workspace

components/                 # Shared UI
argus/                      # Argus domain code
kyklos/                     # Kýklos domain code
components/papyrus/         # Papyrus rendering and page tools

Development

npm install
npm run dev

Validation

npm run lint
npm run build
10 · Design system

Quiet, precise, and intentionally restrained.

Every page shares the same visual foundation: near-black surfaces, translucent panels, compact controls, mono-led typography, restrained accents, purposeful motion, shared custom menus, modal states, toasts, and fixed translucent navigation and footers.

Color tokens

Backgroundvar(--background)
Panelvar(--panel-solid)
Controlvar(--control)
Accentvar(--accent)

Interaction rules

  • • Controls remain compact and clearly clickable.
  • • Motion explains state, never distracts.
  • • Focus and hover states are always visible.
  • • Dark and light themes share the same hierarchy.
11 · Troubleshooting

Common issues and what they mean.

Most issues are caused by unreachable websites, browser extensions, stale development bundles, unsupported browser capabilities, or invalid input.

Argus cannot reach a website

Confirm the URL is public and uses HTTP or HTTPS. Some providers block automated server requests; try another public page to verify.

Hydration warning in development

Browser extensions can modify body attributes before React loads. Test in a private window with extensions disabled before changing application code.

A route returns 404

Use the documented routes exactly. Paths such as /workspace/home are not application routes.

Theme looks incorrect

Clear the ergastirio-theme value in localStorage or use the theme toggle to reset the preference.

Export is blocked

Allow downloads for the site and make sure the browser supports canvas and Blob-based downloads.

Eikón cannot choose a save location

The native save-location picker is browser-dependent. If it is unavailable, the browser download flow remains available.

Bulk export is still preparing

Keep the page open while files are processed locally. When more than one file is ready, Eikón packages the result as a ZIP.

12 · Contributing

Keep changes focused and consistent.

Contributions should solve a clear problem, preserve privacy, reuse the existing visual language, and include validation before submission.

Before opening a PR
  • 1. Keep the scope small and intentional.
  • 2. Match existing component patterns.
  • 3. Avoid unnecessary dependencies.
  • 4. Run lint and a production build.
  • 5. Explain behavior changes clearly.
Project links

That is the complete workshop.

Use the navigation to revisit a section, open a tool to begin working, or view the repository to inspect the implementation.

Return to Ergastírio