From 3c530b6c9d58745a226f0c9d867db893de431785 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20M=20J=20Barata=20Ribeiro?=
 <122732773+Barata-Ribeiro@users.noreply.github.com>
Date: Mon, 20 Jul 2026 13:01:40 -0300
Subject: [PATCH 1/3] feat: implement Text to Speech functionality with form
 validation and voice selection

---
 .../pages/utilities/text-to-speech.tsx        | 190 ++++++++++++++++++
 1 file changed, 190 insertions(+)
 create mode 100644 app/components/pages/utilities/text-to-speech.tsx

diff --git a/app/components/pages/utilities/text-to-speech.tsx b/app/components/pages/utilities/text-to-speech.tsx
new file mode 100644
index 0000000..8f457ed
--- /dev/null
+++ b/app/components/pages/utilities/text-to-speech.tsx
@@ -0,0 +1,190 @@
+import { zodResolver } from '@hookform/resolvers/zod';
+import { useEffect, useState } from 'react';
+import { Controller, useForm } from 'react-hook-form';
+import { z } from 'zod/v4';
+import { Badge } from '~/components/ui/badge';
+import { Button } from '~/components/ui/button';
+import { Field, FieldContent, FieldError, FieldLabel } from '~/components/ui/field';
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '~/components/ui/select';
+import { Slider } from '~/components/ui/slider';
+import { Textarea } from '~/components/ui/textarea';
+
+const TextToSpeechSchema = z.object({
+    text: z
+        .string()
+        .min(10, 'Text must be at least 10 characters long.')
+        .max(5000, 'Text exceeds maximum length of 5000 characters.'),
+    rate: z.number().min(0.5).max(2).default(1).optional(),
+    pitch: z.number().min(0).max(2).default(1).optional(),
+    voice: z.number().min(0).optional(),
+});
+
+type TextToSpeechType = z.infer<typeof TextToSpeechSchema>;
+
+export default function TextToSpeech() {
+    const [voices, setVoices] = useState<SpeechSynthesisVoice[]>([]);
+
+    useEffect(() => {
+        if (typeof globalThis === 'undefined') return;
+
+        const s = globalThis.speechSynthesis;
+        if (!s) return;
+
+        const loadVoices = () => {
+            const v = s.getVoices() ?? [];
+            setVoices(v);
+        };
+
+        loadVoices();
+
+        // In some browsers the voices are not ready on page load
+        const handler = () => loadVoices();
+        s.addEventListener?.('voiceschanged', handler);
+
+        return () => s.removeEventListener?.('voiceschanged', handler);
+    }, []);
+
+    const form = useForm<TextToSpeechType>({
+        resolver: zodResolver(TextToSpeechSchema),
+        defaultValues: { text: '', rate: 1, pitch: 1, voice: undefined },
+    });
+
+    function onsubmit(data: TextToSpeechType) {
+        const s = globalThis.speechSynthesis;
+        if (!s) return;
+
+        s.cancel?.();
+
+        const utter = new SpeechSynthesisUtterance(data.text);
+        utter.rate = data.rate ?? 1;
+        utter.pitch = data.pitch ?? 1;
+
+        if (data.voice !== undefined && data.voice !== null) {
+            const idx = Number(data.voice);
+
+            if (!Number.isNaN(idx) && voices[idx]) utter.voice = voices[idx];
+        }
+
+        s.speak?.(utter);
+    }
+
+    function reset() {
+        form.reset();
+        const s = globalThis.speechSynthesis;
+        s?.cancel?.();
+    }
+
+    return (
+        <form onSubmit={form.handleSubmit(onsubmit)} className="mx-auto mb-6 w-full max-w-lg space-y-6 border-b pb-6">
+            <Controller
+                name="text"
+                control={form.control}
+                render={({ field, fieldState }) => (
+                    <Field data-invalid={fieldState.invalid}>
+                        <FieldLabel htmlFor="text">Text</FieldLabel>
+                        <Textarea
+                            id="text"
+                            maxLength={5000}
+                            placeholder='e.g. "Hello, how are you today?"'
+                            aria-invalid={fieldState.invalid}
+                            {...field}
+                        />
+                        {fieldState.invalid && <FieldError errors={[fieldState.error]} />}
+                    </Field>
+                )}
+            />
+
+            <Controller
+                name="rate"
+                control={form.control}
+                render={({ field, fieldState }) => (
+                    <Field orientation="vertical" data-invalid={fieldState.invalid}>
+                        <FieldLabel htmlFor="rate">Rate</FieldLabel>
+
+                        <div className="flex items-center gap-4">
+                            <Slider
+                                value={[field.value ?? 1]}
+                                onValueChange={([value]) => field.onChange(value)}
+                                min={0.5}
+                                max={2}
+                                step={0.1}
+                            />
+                            <Badge aria-live="polite" className="w-12 tabular-nums select-none">
+                                {(Math.round((field.value ?? 1) * 10) / 10).toFixed(1)}
+                            </Badge>
+                        </div>
+
+                        {fieldState.invalid && <FieldError errors={[fieldState.error]} />}
+                    </Field>
+                )}
+            />
+
+            <Controller
+                name="pitch"
+                control={form.control}
+                render={({ field, fieldState }) => (
+                    <Field orientation="vertical" data-invalid={fieldState.invalid}>
+                        <FieldLabel htmlFor="pitch">Pitch</FieldLabel>
+
+                        <div className="flex items-center gap-4">
+                            <Slider
+                                id="pitch"
+                                value={[field.value ?? 1]}
+                                onValueChange={([value]) => field.onChange(value)}
+                                min={0}
+                                max={2}
+                                step={0.1}
+                            />
+                            <Badge aria-live="polite" className="w-12 tabular-nums select-none">
+                                {(Math.round((field.value ?? 1) * 10) / 10).toFixed(1)}
+                            </Badge>
+                        </div>
+
+                        {fieldState.invalid && <FieldError errors={[fieldState.error]} />}
+                    </Field>
+                )}
+            />
+
+            <Controller
+                control={form.control}
+                name="voice"
+                render={({ field, fieldState }) => (
+                    <Field orientation="responsive" data-invalid={fieldState.invalid}>
+                        <FieldContent>
+                            <FieldLabel htmlFor="voice">Voice</FieldLabel>
+                            {fieldState.invalid && <FieldError errors={[fieldState.error]} />}
+                        </FieldContent>
+
+                        <Select
+                            value={field.value === undefined ? undefined : String(field.value)}
+                            onValueChange={(val) => field.onChange(val === undefined ? undefined : Number(val))}
+                            defaultValue={undefined}
+                        >
+                            <SelectTrigger id="voice" className="w-full" aria-invalid={fieldState.invalid}>
+                                <SelectValue placeholder="Select a voice..." />
+                            </SelectTrigger>
+                            <SelectContent>
+                                {voices.length > 0 ? (
+                                    voices.map((voice, idx) => (
+                                        <SelectItem key={`voice-${idx}-${voice.name}`} value={String(idx)}>
+                                            {voice.name}
+                                        </SelectItem>
+                                    ))
+                                ) : (
+                                    <SelectItem value={String(0)}>Default</SelectItem>
+                                )}
+                            </SelectContent>
+                        </Select>
+                    </Field>
+                )}
+            />
+
+            <div className="grid grid-cols-1 gap-2 sm:grid-cols-2 sm:gap-4">
+                <Button type="submit">Play</Button>
+                <Button type="reset" variant="ghost" onClick={reset} aria-label="Reset Form">
+                    Reset
+                </Button>
+            </div>
+        </form>
+    );
+}

From fa3ad560424dddc05ed293c2275e607025494e79 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20M=20J=20Barata=20Ribeiro?=
 <122732773+Barata-Ribeiro@users.noreply.github.com>
Date: Mon, 20 Jul 2026 13:01:48 -0300
Subject: [PATCH 2/3] feat(routes): add Text to Speech route and page
 implementation

---
 app/routes.ts                           |  1 +
 app/routes/utilities/text-to-speech.tsx | 43 +++++++++++++++++++++++++
 2 files changed, 44 insertions(+)
 create mode 100644 app/routes/utilities/text-to-speech.tsx

diff --git a/app/routes.ts b/app/routes.ts
index 53490c3..a4a855d 100644
--- a/app/routes.ts
+++ b/app/routes.ts
@@ -36,6 +36,7 @@ export default [
         route('/password-generator', 'routes/utilities/password-generator.tsx'),
         route('/qrcode-generator', 'routes/utilities/qrcode-generator.tsx'),
         route('/roman-converter', 'routes/utilities/roman-converter.tsx'),
+        route('/text-to-speech', 'routes/utilities/text-to-speech.tsx'),
     ]),
     route('/theme', 'routes/theme.tsx'),
     route('/sidebar', 'routes/sidebar.tsx'),
diff --git a/app/routes/utilities/text-to-speech.tsx b/app/routes/utilities/text-to-speech.tsx
new file mode 100644
index 0000000..b097763
--- /dev/null
+++ b/app/routes/utilities/text-to-speech.tsx
@@ -0,0 +1,43 @@
+import { Meta } from '~/components/application/meta';
+import TextToSpeech from '~/components/pages/utilities/text-to-speech';
+import { Metadata } from '~/types/metadata';
+
+export const metadata: Metadata = {
+    title: 'Text to Speech',
+    description: 'Convert written text into natural-sounding speech with customizable voices and languages.',
+    keywords: ['text-to-speech', 'speech synthesis', 'natural language processing'],
+    manifest: '/manifest.webmanifest',
+};
+
+export default function Page() {
+    return (
+        <>
+            <Meta {...metadata} />
+            <article className="rounded-md bg-card p-6 shadow">
+                <h1 className="font-serif text-xl">Text to Speech</h1>
+
+                <p className="mt-2 text-sm text-muted-foreground">
+                    Convert written text into natural-sounding speech with customizable voices and languages.
+                </p>
+
+                <section className="mt-4">
+                    <h2 className="sr-only">How it works</h2>
+                    <ul className="list-disc space-y-1 pl-5 text-sm text-muted-foreground">
+                        <li>Input your text into the provided text area.</li>
+                        <li>Select your preferred voice and language options.</li>
+                        <li>Click the &ldquo;Convert&rdquo; button to generate speech from your text.</li>
+                    </ul>
+                </section>
+
+                <div className="mt-4 w-full">
+                    <TextToSpeech />
+                </div>
+
+                <footer className="mt-4 text-xs text-muted-foreground">
+                    Tip: The text to speech functionality relies on your browser&apos;s built-in speech synthesis
+                    capabilities. For the best experience, use a modern browser that supports the Web Speech API.
+                </footer>
+            </article>
+        </>
+    );
+}

From 29eada8948e8b224bbee32da935d0fc7c6c0f6fc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20M=20J=20Barata=20Ribeiro?=
 <122732773+Barata-Ribeiro@users.noreply.github.com>
Date: Mon, 20 Jul 2026 13:24:29 -0300
Subject: [PATCH 3/3] feat(config): add server configuration with security
 headers and base path

---
 vite.config.ts | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/vite.config.ts b/vite.config.ts
index c7552b4..00ab383 100644
--- a/vite.config.ts
+++ b/vite.config.ts
@@ -17,6 +17,7 @@ export default defineConfig(({ mode }) => {
         plugins: [
             tailwindcss(),
             VitePWA({
+                base: '/',
                 outDir: 'build/client',
                 registerType: 'prompt',
                 injectRegister: false,
@@ -177,6 +178,17 @@ export default defineConfig(({ mode }) => {
             sourcemap: false,
             assetsInlineLimit: 4096,
         },
+        server: {
+            port: 5173,
+            headers: {
+                'x-content-type-options': 'nosniff',
+                'Referrer-Policy': 'no-referrer',
+                'Permissions-Policy': 'geolocation=(), microphone=(), camera=()',
+                'X-Frame-Options': 'DENY',
+                'X-XSS-Protection': '1; mode=block',
+                'Strict-Transport-Security': 'max-age=31536000; includeSubDomains; preload',
+            },
+        },
         test: {
             globals: true,
             environment: 'jsdom',