diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d0a7840
--- /dev/null
+++ b/README.md
@@ -0,0 +1,119 @@
+# SourceVortex
+
+Front-end do [sourcevortex.com.br](https://sourcevortex.com.br) em Laravel + Inertia + Vue.
+
+Este projeto **não tem banco próprio**. Ele lê, em modo somente leitura, as tabelas de uma
+instalação existente do WordPress (`wp_posts`, `wp_postmeta`, `wp_terms`, `wp_term_taxonomy`,
+`wp_term_relationships`, `wp_users`, `wp_usermeta`) através de models Eloquent. O WordPress
+continua sendo onde o conteúdo é escrito e administrado; aqui só se lê e se renderiza.
+
+## Stack
+
+| | |
+|---|---|
+| Back-end | Laravel 12, PHP 8.2+ |
+| Front-end | Vue 3, TypeScript, Inertia 2 |
+| Build | Vite 7, Tailwind 4 |
+| Componentes | reka-ui (shadcn-vue) |
+| Testes | Pest 3 |
+
+## Requisitos
+
+- PHP 8.2 ou superior
+- Composer
+- Node 22 ou superior
+- MySQL **com as tabelas do WordPress já populadas**
+
+## Instalação
+
+```bash
+composer install
+npm ci
+cp .env.example .env
+php artisan key:generate
+```
+
+Aponte o `.env` para o banco do WordPress:
+
+```dotenv
+DB_CONNECTION=mysql
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_DATABASE=nome_do_banco_wordpress
+DB_USERNAME=usuario
+DB_PASSWORD=senha
+
+# URL da instalação do WordPress, usada para montar os links do painel
+WP_ADMIN_URL=https://exemplo.com.br
+```
+
+> **Não rode `php artisan migrate` contra o banco do WordPress** sem entender o efeito.
+> As migrations do esqueleto do Laravel criam tabelas (`users`, `cache`, `jobs`) dentro
+> do mesmo schema. Se `CACHE_STORE` ou `SESSION_DRIVER` estiverem em `database`, o Laravel
+> passa a escrever no banco do WordPress. Prefira `redis` ou `file`.
+
+Para desenvolver:
+
+```bash
+composer dev
+```
+
+Sobe servidor, fila, logs e Vite em paralelo.
+
+## Testes
+
+```bash
+php artisan test
+```
+
+Os testes **não precisam** do banco do WordPress. `tests/Support/WordPressSchema.php`
+cria as tabelas `wp_*` em sqlite na memória, e `tests/Support/Wp.php` traz construtores
+para as linhas. Como o app não tem migration para essas tabelas, esse é o único lugar
+onde o schema esperado está descrito — vale mantê-lo em dia com a instalação real.
+
+## Qualidade
+
+```bash
+vendor/bin/pint --test   # estilo PHP
+npm run format:check     # formatação do front
+npm run lint:check       # eslint
+npm run type-check       # vue-tsc
+```
+
+Os quatro rodam no CI e reprovam o build.
+
+## Convenções que vêm do WordPress
+
+Algumas regras de negócio moram no conteúdo, não no código:
+
+| Convenção | Efeito |
+|---|---|
+| Categoria `destaques` | Posts nela aparecem no carrossel da home e **saem** da listagem principal |
+| Menu chamado `Menu` | É o menu principal do site |
+| Página com slug `politica-de-privacidade` | Alimenta a rota `/politica-de-privacidade` |
+
+As URLs seguem o permalink padrão do WordPress (`/%year%/%monthnum%/%postname%`), o que
+mantém os endereços do site antigo válidos.
+
+## ⚠️ Dependência de plugin: Advanced Custom Fields
+
+O subtítulo exibido na capa do post vem de `wp_postmeta` com `meta_key = 'subtitle'`.
+Esse campo é criado pelo **Advanced Custom Fields** no WordPress — o tema V1 o lia com
+`get_field("subtitle")`.
+
+Isso significa que:
+
+- o ACF precisa continuar instalado e o campo `subtitle` precisa continuar existindo;
+- se o campo for movido para dentro de um *group* ou *repeater*, o `meta_key` muda de
+  formato e o subtítulo **some silenciosamente** aqui, sem erro nenhum.
+
+Não há como este projeto detectar essa quebra sozinho. Se o subtítulo sumir do site,
+comece a investigação pela configuração do ACF.
+
+## Diferenças em relação ao tema antigo
+
+O tema WordPress que este projeto substitui tinha alguns recursos que não foram portados:
+
+- **Comentários** — descontinuados por decisão de produto.
+- **Anúncios (AdSense)** — o tema tinha quatro posições. Não estão aqui.
+- **AMP, post formats e página de biografia** — não portados.
diff --git a/app/Http/Middleware/HandleInertiaRequests.php b/app/Http/Middleware/HandleInertiaRequests.php
index 0dd251b..ff0b8ea 100644
--- a/app/Http/Middleware/HandleInertiaRequests.php
+++ b/app/Http/Middleware/HandleInertiaRequests.php
@@ -4,7 +4,6 @@
 
 use App\Services\WpAuthService;
 use App\Services\WpMenuService;
-use Illuminate\Foundation\Inspiring;
 use Illuminate\Http\Request;
 use Inertia\Middleware;
 use Tighten\Ziggy\Ziggy;
@@ -39,14 +38,11 @@ public function version(Request $request): ?string
      */
     public function share(Request $request): array
     {
-        [$message, $author] = str(Inspiring::quotes()->random())->explode('-');
-
         $wpUser = WpAuthService::getLoggedInWpUser();
 
         return [
             ...parent::share($request),
             'name' => config('app.name'),
-            'quote' => ['message' => trim($message), 'author' => trim($author)],
             'auth' => [
                 'user' => $request->user(),
             ],
diff --git a/app/Models/WpPost.php b/app/Models/WpPost.php
index 0ae7b32..30c6706 100644
--- a/app/Models/WpPost.php
+++ b/app/Models/WpPost.php
@@ -90,8 +90,14 @@ public function useSearchTerm(Builder $query, ?string $searchTerm = null): void
             return;
         }
 
-        $query->where('post_title', 'LIKE', "%{$searchTerm}%")
-            ->orWhere('post_content', 'LIKE', "%{$searchTerm}%");
+        // Grouped explicitly. Laravel currently nests the wheres a named scope
+        // adds, so the OR does not leak today — but that is a property of how
+        // the scope is invoked, not of this code, and it breaks the moment the
+        // condition is inlined into a query.
+        $query->where(function (Builder $query) use ($searchTerm) {
+            $query->where('post_title', 'LIKE', "%{$searchTerm}%")
+                ->orWhere('post_content', 'LIKE', "%{$searchTerm}%");
+        });
     }
 
     #[Scope]
diff --git a/app/Services/WpCategoryService.php b/app/Services/WpCategoryService.php
index 53e2f6b..1fc9dea 100644
--- a/app/Services/WpCategoryService.php
+++ b/app/Services/WpCategoryService.php
@@ -13,7 +13,11 @@ public static function getCategoryBySlug($slug)
 
         return cache()->remember($cacheKey, $cacheTTL, function () use ($slug) {
             return WpTerm::query()
-                ->where('slug', $slug)
+                // Slugs are only unique within a taxonomy: without this filter a
+                // tag sharing a category's slug could be returned instead.
+                ->join('wp_term_taxonomy', 'wp_term_taxonomy.term_id', '=', 'wp_terms.term_id')
+                ->where('wp_term_taxonomy.taxonomy', 'category')
+                ->where('wp_terms.slug', $slug)
                 ->first();
         });
     }
diff --git a/bootstrap/app.php b/bootstrap/app.php
index a827a7f..14455db 100644
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -1,5 +1,6 @@
 <?php
 
+use App\Http\Middleware\HandleAppearance;
 use App\Http\Middleware\HandleInertiaRequests;
 use Illuminate\Foundation\Application;
 use Illuminate\Foundation\Configuration\Exceptions;
@@ -14,6 +15,11 @@
     )
     ->withMiddleware(function (Middleware $middleware) {
         $middleware->web(append: [
+            // Reads the appearance cookie the theme switcher writes and shares
+            // it with the root view. It existed but was never registered, so
+            // the cookie was written and never read, and anyone who picked a
+            // theme explicitly got a flash of the wrong one on every full load.
+            HandleAppearance::class,
             HandleInertiaRequests::class,
             AddLinkHeadersForPreloadedAssets::class,
         ]);
diff --git a/config/inertia.php b/config/inertia.php
index d15cad9..575d918 100644
--- a/config/inertia.php
+++ b/config/inertia.php
@@ -15,9 +15,12 @@
     |
     */
 
+    // Off by default: when this is true and no SSR process is listening, every
+    // request pays for a failed connection to 127.0.0.1:13714 before falling
+    // back to client rendering. `composer dev` does not start that process.
     'ssr' => [
-        'enabled' => true,
-        'url' => 'http://127.0.0.1:13714',
+        'enabled' => env('INERTIA_SSR_ENABLED', false),
+        'url' => env('INERTIA_SSR_URL', 'http://127.0.0.1:13714'),
         // 'bundle' => base_path('bootstrap/ssr/ssr.mjs'),
     ],
 
diff --git a/phpunit.xml b/phpunit.xml
index c09b5bc..61c031c 100644
--- a/phpunit.xml
+++ b/phpunit.xml
@@ -22,7 +22,8 @@
         <env name="APP_MAINTENANCE_DRIVER" value="file"/>
         <env name="BCRYPT_ROUNDS" value="4"/>
         <env name="CACHE_STORE" value="array"/>
-        <env name="DB_DATABASE" value="testing"/>
+        <env name="DB_CONNECTION" value="sqlite"/>
+        <env name="DB_DATABASE" value=":memory:"/>
         <env name="MAIL_MAILER" value="array"/>
         <env name="PULSE_ENABLED" value="false"/>
         <env name="QUEUE_CONNECTION" value="sync"/>
diff --git a/resources/js/components/Carousel.vue b/resources/js/components/Carousel.vue
index 5386bec..15c76b4 100644
--- a/resources/js/components/Carousel.vue
+++ b/resources/js/components/Carousel.vue
@@ -45,13 +45,15 @@ watchOnce(api, (api) => {
             :opts="{
                 loop: true,
             }"
-            :plugins="[Autoplay({
-                delay: 5000,
-                active: true,
-                stopOnFocusIn: false,
-                stopOnInteraction: false,
-                stopOnMouseEnter: false,
-            })]"
+            :plugins="[
+                Autoplay({
+                    delay: 5000,
+                    active: true,
+                    stopOnFocusIn: false,
+                    stopOnInteraction: false,
+                    stopOnMouseEnter: false,
+                }),
+            ]"
         >
             <CarouselContent>
                 <CarouselItem v-for="(post, idx) in highlightedPosts.data" :key="post.id" class="relative">
@@ -62,7 +64,7 @@ watchOnce(api, (api) => {
     </div>
     <div class="mt-5 mb-0 flex justify-center xl:my-10">
         <button
-            v-for="i in 5"
+            v-for="i in totalCount"
             v-bind:key="i"
             class="mx-2 h-[15px] w-[15px] cursor-pointer p-1"
             :class="current === i ? 'opacity-100' : 'opacity-50'"
diff --git a/resources/js/components/HeaderSearchForm.vue b/resources/js/components/HeaderSearchForm.vue
index 8d56b97..2afb2bf 100644
--- a/resources/js/components/HeaderSearchForm.vue
+++ b/resources/js/components/HeaderSearchForm.vue
@@ -23,17 +23,6 @@ const handleSubmit = () => {
     });
 };
 
-const handleSearchBlur = () => {
-    if (!formRef.value) return;
-    if (!inputRef.value) return;
-
-    const termOnInput = inputRef.value.value as string;
-
-    if (!searchTerm.value || searchTerm.value !== termOnInput) {
-        handleSubmit();
-    }
-};
-
 watch(
     () => searchOpen,
     () => {
@@ -67,7 +56,6 @@ defineExpose({
             class="slide-search-transition absolute right-[42px] h-[42px] rounded-tl-xs rounded-bl-xs border-0 bg-white px-4 py-2 text-black outline-0"
             :class="{ 'w-0! p-0!': !searchOpen }"
             placeholder="Buscar..."
-            @blur="handleSearchBlur"
         />
     </form>
 </template>
diff --git a/resources/js/components/Sidebar.vue b/resources/js/components/Sidebar.vue
index 3d14143..31a7c25 100644
--- a/resources/js/components/Sidebar.vue
+++ b/resources/js/components/Sidebar.vue
@@ -1,7 +1,16 @@
 <script setup lang="ts"></script>
 
 <template>
-    <div class="h-[500px] w-full bg-gray-800"></div>
+    <!--
+        Intentionally empty.
+
+        This used to render a 500px grey block (bg-gray-800) on every desktop
+        page: a placeholder that shipped to production. Rendering nothing reads
+        better than rendering a fake panel while the column has no content.
+
+        The WordPress theme this project replaces filled this column with an ad
+        unit; whether that comes back is the site owner's call.
+    -->
 </template>
 
 <style scoped></style>
diff --git a/resources/js/composables/useAppearance.ts b/resources/js/composables/useAppearance.ts
index 24f4d36..46309cf 100644
--- a/resources/js/composables/useAppearance.ts
+++ b/resources/js/composables/useAppearance.ts
@@ -64,9 +64,11 @@ export function initializeTheme() {
     mediaQuery()?.addEventListener('change', handleSystemThemeChange);
 }
 
-export function useAppearance() {
-    const appearance = ref<Appearance>(defaultTheme);
+// Module scope on purpose: the header renders a ThemeButton for desktop and
+// another for mobile, and a ref created per call would let their icons disagree.
+const appearance = ref<Appearance>(defaultTheme);
 
+export function useAppearance() {
     onMounted(() => {
         const savedAppearance = localStorage.getItem('appearance') as Appearance | null;
 
diff --git a/resources/js/types/index.d.ts b/resources/js/types/index.d.ts
index e33f49d..ee05870 100644
--- a/resources/js/types/index.d.ts
+++ b/resources/js/types/index.d.ts
@@ -21,7 +21,6 @@ export interface WpAdmin {
 
 export type AppPageProps<T extends Record<string, unknown> = Record<string, unknown>> = T & {
     name: string;
-    quote: { message: string; author: string };
     auth: Auth;
     ziggy: Config & { location: string };
     wpAdmin: WpAdmin | null;
@@ -40,20 +39,20 @@ export interface User {
 export interface LaravelPagination<T> {
     data: T;
     links: {
-        first: string|null;
-        last: string|null;
-        prev: string|null;
-    },
+        first: string | null;
+        last: string | null;
+        prev: string | null;
+    };
     meta: {
         current_page: number;
-        from: number|null;
+        from: number | null;
         last_page: number;
-        links: { url: string|null; label: string; active: boolean }[];
+        links: { url: string | null; label: string; active: boolean }[];
         path: string;
         per_page: number;
-        to: number|null;
+        to: number | null;
         total: number;
-    }
+    };
 }
 
 export interface WpMenuItem {
@@ -98,7 +97,7 @@ export interface Post {
         day: string;
         hour?: string;
         minute?: string;
-    },
+    };
     content?: string;
     subtitle?: string;
     author_description?: string;
diff --git a/tests/Feature/ExampleTest.php b/tests/Feature/ExampleTest.php
deleted file mode 100644
index 1e2a000..0000000
--- a/tests/Feature/ExampleTest.php
+++ /dev/null
@@ -1,7 +0,0 @@
-<?php
-
-test('returns a successful response', function () {
-    $response = $this->get('/');
-
-    $response->assertStatus(200);
-});
diff --git a/tests/Feature/RoutesTest.php b/tests/Feature/RoutesTest.php
new file mode 100644
index 0000000..8ebf750
--- /dev/null
+++ b/tests/Feature/RoutesTest.php
@@ -0,0 +1,139 @@
+<?php
+
+use Tests\Support\Wp;
+
+/**
+ * Smoke coverage for every route in routes/web.php.
+ *
+ * Before this file the only feature test was `GET /` asserting 200, and it
+ * could not pass because no wp_* table existed in the test database.
+ */
+beforeEach(function () {
+    $this->author = Wp::user([
+        'user_login' => 'mayron',
+        'user_nicename' => 'mayron',
+        'display_name' => 'Autor Um',
+        'user_email' => 'autor@example.com',
+    ]);
+
+    $this->post = Wp::post([
+        'post_author' => $this->author->ID,
+        'post_title' => 'Primeiro post',
+        'post_name' => 'primeiro-post',
+        'post_date' => '2026-07-15 12:00:00',
+    ]);
+
+    Wp::categorise($this->post->ID, 'games');
+    Wp::categorise($this->post->ID, 'lancamentos', 'post_tag');
+    Wp::thumbnail($this->post->ID);
+});
+
+it('renders the home page', function () {
+    $this->get('/')
+        ->assertOk()
+        ->assertInertia(fn ($page) => $page
+            ->component('Home')
+            ->has('posts.data', 1)
+            ->where('posts.data.0.title', 'Primeiro post')
+        );
+});
+
+it('excludes highlighted posts from the home listing', function () {
+    $highlighted = Wp::post(['post_title' => 'Em destaque', 'post_name' => 'em-destaque']);
+    Wp::categorise($highlighted->ID, 'destaques');
+
+    $this->get('/')
+        ->assertOk()
+        ->assertInertia(fn ($page) => $page
+            ->has('posts.data', 1)
+            ->has('highlightedPosts.data', 1)
+            ->where('posts.data.0.title', 'Primeiro post')
+            ->where('highlightedPosts.data.0.title', 'Em destaque')
+        );
+});
+
+it('renders a single post', function () {
+    $this->get('/2026/07/primeiro-post')
+        ->assertOk()
+        ->assertInertia(fn ($page) => $page
+            ->component('PostContent')
+            ->where('post.data.title', 'Primeiro post')
+            ->where('post.data.slug', 'primeiro-post')
+        );
+});
+
+it('returns 404 for an unknown post slug', function () {
+    $this->get('/2026/07/nao-existe')->assertNotFound();
+});
+
+it('renders the category listing', function () {
+    $this->get('/category/games')
+        ->assertOk()
+        ->assertInertia(fn ($page) => $page
+            ->component('CategoryPosts')
+            ->has('posts.data', 1)
+        );
+});
+
+it('renders the tag listing', function () {
+    $this->get('/tag/lancamentos')
+        ->assertOk()
+        ->assertInertia(fn ($page) => $page
+            ->component('TagPosts')
+            ->has('posts.data', 1)
+        );
+});
+
+it('renders the author listing', function () {
+    $this->get('/author/mayron')
+        ->assertOk()
+        ->assertInertia(fn ($page) => $page
+            ->component('AuthorPosts')
+            ->has('posts.data', 1)
+        );
+});
+
+it('renders the year and month archive', function () {
+    $this->get('/2026/07')
+        ->assertOk()
+        ->assertInertia(fn ($page) => $page
+            ->component('YearMonthPosts')
+            ->has('posts.data', 1)
+        );
+});
+
+it('renders the privacy policy page', function () {
+    Wp::post([
+        'post_title' => 'Politica de Privacidade',
+        'post_name' => 'politica-de-privacidade',
+        'post_type' => 'page',
+    ]);
+
+    $this->get('/politica-de-privacidade')
+        ->assertOk()
+        ->assertInertia(fn ($page) => $page
+            ->component('PrivacyPolicy')
+            ->where('page.data.title', 'Politica de Privacidade')
+        );
+});
+
+it('finds posts by search term', function () {
+    Wp::post(['post_title' => 'Outro assunto', 'post_name' => 'outro-assunto']);
+
+    $this->get('/?s=Primeiro')
+        ->assertOk()
+        ->assertInertia(fn ($page) => $page
+            ->where('searchTerm', 'Primeiro')
+            ->has('posts.data', 1)
+            ->where('posts.data.0.title', 'Primeiro post')
+        );
+});
+
+it('hides posts that are not published', function () {
+    Wp::post(['post_title' => 'Rascunho', 'post_name' => 'rascunho', 'post_status' => 'draft']);
+    Wp::post(['post_title' => 'Futuro', 'post_name' => 'futuro', 'post_date' => '2099-01-01 00:00:00']);
+
+    $this->get('/')
+        ->assertOk()
+        ->assertInertia(fn ($page) => $page->has('posts.data', 1));
+});
diff --git a/tests/Pest.php b/tests/Pest.php
index 40d096b..3c76ee0 100644
--- a/tests/Pest.php
+++ b/tests/Pest.php
@@ -13,6 +13,17 @@
 
 pest()->extend(Tests\TestCase::class)
     ->use(Illuminate\Foundation\Testing\RefreshDatabase::class)
+    ->beforeEach(function () {
+        // The app reads an existing WordPress database, so there are no
+        // migrations for wp_* tables. Build them per test instead.
+        Tests\Support\WordPressSchema::create();
+
+        // Rendering the root Blade view resolves @vite, which needs a built
+        // manifest. Stub it so the suite does not depend on `npm run build`.
+        $this->withoutVite();
+
+        cache()->flush();
+    })
     ->in('Feature');
 
 /*
diff --git a/tests/Support/WordPressSchema.php b/tests/Support/WordPressSchema.php
new file mode 100644
index 0000000..df23af6
--- /dev/null
+++ b/tests/Support/WordPressSchema.php
@@ -0,0 +1,104 @@
+<?php
+
+namespace Tests\Support;
+
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Creates the WordPress tables this application reads.
+ *
+ * The app has no migrations for them — it points Eloquent models at an existing
+ * WordPress database — so without this the whole suite can only test code that
+ * never touches the database.
+ *
+ * Column types mirror WordPress core closely enough for the queries in
+ * App\Models and App\Services to behave as they do in production. Columns the
+ * application never reads are omitted on purpose, to keep the fixture readable.
+ */
+class WordPressSchema
+{
+    /**
+     * @var list<string> Drop order matters only for readability; sqlite has no FKs here.
+     */
+    private const TABLES = [
+        'wp_posts',
+        'wp_postmeta',
+        'wp_users',
+        'wp_usermeta',
+        'wp_terms',
+        'wp_term_taxonomy',
+        'wp_term_relationships',
+    ];
+
+    public static function create(): void
+    {
+        self::drop();
+
+        Schema::create('wp_posts', function (Blueprint $table) {
+            $table->id('ID');
+            $table->unsignedBigInteger('post_author')->default(0);
+            $table->dateTime('post_date')->nullable();
+            $table->longText('post_content')->nullable();
+            $table->text('post_title')->nullable();
+            $table->text('post_excerpt')->nullable();
+            $table->string('post_status', 20)->default('publish');
+            $table->string('post_name', 200)->default('');
+            $table->string('post_type', 20)->default('post');
+            $table->string('guid', 255)->default('');
+            $table->integer('menu_order')->default(0);
+            $table->unsignedBigInteger('post_parent')->default(0);
+        });
+
+        Schema::create('wp_postmeta', function (Blueprint $table) {
+            $table->id('meta_id');
+            $table->unsignedBigInteger('post_id')->default(0);
+            $table->string('meta_key', 255)->nullable();
+            $table->longText('meta_value')->nullable();
+        });
+
+        Schema::create('wp_users', function (Blueprint $table) {
+            $table->id('ID');
+            $table->string('user_login', 60)->default('');
+            $table->string('user_pass', 255)->default('');
+            $table->string('user_nicename', 50)->default('');
+            $table->string('user_email', 100)->default('');
+            $table->string('display_name', 250)->default('');
+        });
+
+        Schema::create('wp_usermeta', function (Blueprint $table) {
+            $table->id('umeta_id');
+            $table->unsignedBigInteger('user_id')->default(0);
+            $table->string('meta_key', 255)->nullable();
+            $table->longText('meta_value')->nullable();
+        });
+
+        Schema::create('wp_terms', function (Blueprint $table) {
+            $table->id('term_id');
+            $table->string('name', 200)->default('');
+            $table->string('slug', 200)->default('');
+        });
+
+        Schema::create('wp_term_taxonomy', function (Blueprint $table) {
+            $table->id('term_taxonomy_id');
+            $table->unsignedBigInteger('term_id')->default(0);
+            $table->string('taxonomy', 32)->default('');
+            $table->longText('description')->nullable();
+            $table->unsignedBigInteger('parent')->default(0);
+            $table->bigInteger('count')->default(0);
+        });
+
+        Schema::create('wp_term_relationships', function (Blueprint $table) {
+            $table->unsignedBigInteger('object_id')->default(0);
+            $table->unsignedBigInteger('term_taxonomy_id')->default(0);
+            $table->integer('term_order')->default(0);
+        });
+    }
+
+    public static function drop(): void
+    {
+        foreach (self::TABLES as $table) {
+            Schema::dropIfExists($table);
+        }
+    }
+}
diff --git a/tests/Support/Wp.php b/tests/Support/Wp.php
new file mode 100644
index 0000000..9c29ebf
--- /dev/null
+++ b/tests/Support/Wp.php
@@ -0,0 +1,130 @@
+<?php
+
+namespace Tests\Support;
+
+use App\Models\WpPost;
+use App\Models\WpUser;
+use Illuminate\Support\Facades\DB;
+
+/**
+ * Small builders for WordPress rows.
+ *
+ * Eloquent factories are not used here: the Wp* models declare no $fillable and
+ * several use non-conventional primary keys, so plain inserts stay closer to
+ * what the production database actually contains.
+ */
+class Wp
+{
+    public static function user(array $attributes = []): WpUser
+    {
+        $id = DB::table('wp_users')->insertGetId(array_merge([
+            'user_login' => 'autor',
+            'user_pass' => '$P$Bexamplehashexamplehashexample',
+            'user_nicename' => 'autor',
+            'user_email' => 'autor@example.com',
+            'display_name' => 'Autor de Teste',
+        ], $attributes), 'ID');
+
+        return WpUser::query()->findOrFail($id);
+    }
+
+    public static function post(array $attributes = []): WpPost
+    {
+        $id = DB::table('wp_posts')->insertGetId(array_merge([
+            'post_author' => 1,
+            'post_date' => '2026-07-15 12:00:00',
+            'post_title' => 'Post de teste',
+            'post_excerpt' => 'Resumo do post.',
+            'post_content' => 'Conteudo do post.',
+            'post_name' => 'post-de-teste',
+            'post_status' => 'publish',
+            'post_type' => 'post',
+        ], $attributes), 'ID');
+
+        return WpPost::withoutGlobalScopes()->findOrFail($id);
+    }
+
+    /**
+     * Creates a term in the given taxonomy and returns its term_taxonomy_id.
+     */
+    public static function term(string $slug, string $taxonomy = 'category', ?string $name = null): int
+    {
+        $termId = DB::table('wp_terms')->insertGetId([
+            'name' => $name ?? ucfirst($slug),
+            'slug' => $slug,
+        ], 'term_id');
+
+        return DB::table('wp_term_taxonomy')->insertGetId([
+            'term_id' => $termId,
+            'taxonomy' => $taxonomy,
+        ], 'term_taxonomy_id');
+    }
+
+    public static function attach(int $postId, int $termTaxonomyId): void
+    {
+        DB::table('wp_term_relationships')->insert([
+            'object_id' => $postId,
+            'term_taxonomy_id' => $termTaxonomyId,
+        ]);
+    }
+
+    /**
+     * Convenience: create the term if needed and attach it in one call.
+     */
+    public static function categorise(int $postId, string $slug, string $taxonomy = 'category'): int
+    {
+        $ttId = DB::table('wp_term_taxonomy')
+            ->join('wp_terms', 'wp_terms.term_id', '=', 'wp_term_taxonomy.term_id')
+            ->where('wp_terms.slug', $slug)
+            ->where('wp_term_taxonomy.taxonomy', $taxonomy)
+            ->value('wp_term_taxonomy.term_taxonomy_id');
+
+        $ttId ??= self::term($slug, $taxonomy);
+
+        self::attach($postId, $ttId);
+
+        return $ttId;
+    }
+
+    /**
+     * Attaches a featured image: an attachment post plus the _thumbnail_id meta
+     * that WpPost::getThumbnail() resolves.
+     */
+    public static function thumbnail(int $postId, string $url = 'https://example.com/capa.jpg'): int
+    {
+        $attachmentId = DB::table('wp_posts')->insertGetId([
+            'post_title' => 'capa',
+            'post_name' => 'capa',
+            'post_type' => 'attachment',
+            'post_status' => 'inherit',
+            'post_date' => '2026-07-15 12:00:00',
+            'guid' => $url,
+        ], 'ID');
+
+        DB::table('wp_postmeta')->insert([
+            'post_id' => $postId,
+            'meta_key' => '_thumbnail_id',
+            'meta_value' => (string) $attachmentId,
+        ]);
+
+        return $attachmentId;
+    }
+
+    public static function postMeta(int $postId, string $key, string $value): void
+    {
+        DB::table('wp_postmeta')->insert([
+            'post_id' => $postId,
+            'meta_key' => $key,
+            'meta_value' => $value,
+        ]);
+    }
+
+    public static function userMeta(int $userId, string $key, string $value): void
+    {
+        DB::table('wp_usermeta')->insert([
+            'user_id' => $userId,
+            'meta_key' => $key,
+            'meta_value' => $value,
+        ]);
+    }
+}