Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings
/ cat Public

Google-style, multilingual UI to search, fetch, and customize cat images via the CATAAS API. Supports tags, GIFs, text overlays, filters (blur/mono/negate/custom), HSL/RGB tweaks, size and dimension controls, and an 'I'm Feeling Lucky' option with automatic random-cat fallback.

Notifications You must be signed in to change notification settings

michelbr84/cat

Repository files navigation

Cat Google Translate

Cat Google Translate hero

Google-like interface to search and generate cat images using the CATAAS (Cat as a Service) API, with multi-language support and advanced options.

API links:

Run locally

Requirements: Node.js 18+ and npm.

git clone https://github.com/michelbr84/cat-google-translate.git
cd cat-google-translate
npm ci
npm run dev
# Open the URL printed in the terminal (e.g., http://localhost:8080/)

Scripts

  • npm run dev: start Vite dev server
  • npm run build: production build
  • npm run preview: preview the production build
  • npm run lint: run linter

Features

  • Global language selector (pt, en, es, fr, de, it, ja, zh, ru, ar)
  • The "Gato" logo word changes language independently on click (does not alter the global language)
  • Search bar with "Search Cat" and "I'm Feeling Lucky"
  • Advanced options (collapsible):
    • Image type: type (xsmall, small, medium, square)
    • Filters: filter (blur, mono, negate, custom)
    • Custom HSL: brightness, lightness, saturation, hue
    • RGB adjustments: r, g, b
    • Dimensions: width, height
    • Text on image: says/:text (with fontSize and fontColor)
  • Automatic fallback: on load failure, fetch a random cat (/cat)

CATAAS endpoint examples

  • Random: /cat
  • By tag: /cat/:tag
  • GIF: /cat/gif
  • With text: /cat/says/Hello
  • Combo (from docs): /cat/gif/says/Hello?filter=mono&fontColor=orange&fontSize=20&type=square

Known limitations

  • fontColor on /cat/says/:text currently seems inconsistent and often renders only black/white. Even when sending named colors (e.g., red, orange) or normalized hex (e.g., #ff0000red), the text may still appear black. In our tests, white is more reliable. This is an upstream CATAAS behavior and is tracked in TODO.md.
  • On development, you may see warnings from browser extensions in the console. We filter some known noisy messages in dev; they do not affect the app.

Tech stack

  • Vite + React + TypeScript
  • Tailwind CSS + shadcn/ui
  • lucide-react, sonner

Acknowledgements

Deploy

You can deploy to any static host that serves the dist/ folder. Common options:

  • Vercel / Netlify: set build command npm run build and publish directory dist/.

  • Static server: npx serve dist.

  • Image API: CATAAS

About

Google-style, multilingual UI to search, fetch, and customize cat images via the CATAAS API. Supports tags, GIFs, text overlays, filters (blur/mono/negate/custom), HSL/RGB tweaks, size and dimension controls, and an 'I'm Feeling Lucky' option with automatic random-cat fallback.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

AltStyle によって変換されたページ (->オリジナル) /