Saya menambahkan 9 game browser ke portofolio tanpa membuatnya lambat
Portofolio saya sekarang punya halaman game berisi sembilan game kecil, dari Snake sampai Minesweeper. Halaman beranda, portofolio, dan blog tidak bertambah berat sedikit pun. Ini cara kerjanya, angka yang saya ukur, dan bug yang tertangkap lewat pengujian sebelum ada yang bermain.
- Next.js
- Performance
- Frontend
- Games
Portofolio saya adalah situs Next.js statis yang disimpan di storage bucket. Tidak ada server, jadi setiap halaman hanya berupa HTML biasa dan sedikit JavaScript. Tidak lama setelah situsnya rilis, saya ingin menambahkan sesuatu yang seru: halaman berisi game kecil yang bisa dimainkan saat rehat.
Kekhawatiran pertama tentu soal kecepatan. Portofolio kebanyakan dibaca oleh recruiter dan klien, sering kali lewat ponsel, dan tidak ada yang merekrut kita karena halaman beranda yang lambat. Jadi sebelum menulis kode game apa pun, saya membuat satu aturan:
Halaman beranda, portofolio, blog, dan kontak tidak boleh bertambah berat. Sedikit pun.
Halaman game sekarang punya sembilan game: Bug Smash, Tech Stack Memory, Snake, Version Bump (2048), Ship It, Merge Conflict (Minesweeper), Portrait Puzzle, Code Typing Race, dan Guess the Stack. Ini cara saya menjaganya tetap cepat.
Angkanya dulu
Saya mengukur ukuran JavaScript (terkompresi) yang diunduh setiap halaman, sebelum ada game dan setelah setiap tahap penambahan game:
- Beranda: 256,0 KB sebelum ada game, 256,0 KB dengan sembilan game.
- Portofolio: 246,1 KB sebelumnya, 246,1 KB sesudahnya.
- Blog: 227,4 KB sebelumnya, 227,4 KB sesudahnya.
- Setiap game: sekitar 3 sampai 4,5 KB, dan hanya dimuat di halaman game itu sendiri. Guess the Stack 14,5 KB karena berisi data portofolio saya.
Tapi angkanya tidak selalu nol. Tahap pertama game sempat menambah 0,3 KB di setiap halaman, dan di bawah saya jelaskan dari mana asalnya dan bagaimana saya menghapusnya lagi.
Angka dari hasil build saja tidak cukup, jadi saya juga mengujinya di browser sungguhan. Di setiap halaman biasa saya scroll sampai bawah, mengarahkan kursor ke setiap link menuju game, lalu mendaftar semua file yang diunduh browser. Hasilnya: nol file game di halaman mana pun selain halaman game.
1. Satu game, satu file, satu halaman
Setiap game adalah file tersendiri, dimuat dengan next/dynamic dan hanya di browser:
const browserOnly = { ssr: false };
const games = {
snake: dynamic(() => import("@/games/snake"), browserOnly),
memory: dynamic(() => import("@/games/tech-memory"), browserOnly),
// …satu baris per game
};
Next.js mengubah setiap import() menjadi file kecil yang terpisah. Halaman Snake hanya meminta file Snake, tidak ada yang lain. Halaman daftar game tidak meminta satu pun. Halaman itu hanya menampilkan kartu dengan pratinjau kecil yang digambar dengan CSS dan SVG, tanpa gambar dan tanpa kode game.
ssr: false juga penting. Game butuh browser (canvas, keyboard, skor yang disimpan), jadi tidak ada gunanya me-render-nya di server. Bagian halaman di sekitar game (judul, cara bermain, link) tetap HTML statis biasa, jadi cepat dimuat dan bisa dibaca mesin pencari.
2. Jangan biarkan menu mengunduh game
Secara default, Next.js melakukan prefetch pada halaman tujuan link supaya klik terasa instan. Itu bagus untuk halaman utama, tapi link "Game" ada di navbar dan footer setiap halaman. Kalau prefetch aktif, setiap pengunjung beranda diam-diam ikut mengunduh sebagian halaman game.
Solusinya cukup satu atribut di setiap link menuju game:
<Link href="/games/" prefetch={false}>Games</Link>
Sekarang game baru dimuat saat seseorang benar-benar mengkliknya.
3. Jaga teks bersama tetap kecil
Bagian ini hampir terlewat, dan dari sinilah 0,3 KB tadi berasal.
Versi pertama saya menyimpan teks game bersama teks situs lainnya: nama, deskripsi, label tombol, dan petunjuk "Cara bermain" untuk setiap game, dalam bahasa Inggris dan Indonesia. Teks situs dimuat di setiap halaman, jadi setiap pengunjung ikut mengunduh petunjuk game yang tidak akan mereka baca. Untuk tiga game hanya 0,3 KB, tapi ukurannya akan terus bertambah setiap ada game baru.
Jadi saya memecahnya:
- File bersama hanya berisi yang dibutuhkan halaman daftar: nama setiap game, deskripsi satu baris, dan lama permainannya.
- Teks milik setiap game (label, pesan, petunjuk) disimpan di samping game-nya dan dimuat bersamanya.
- Daftar "Cara bermain" dimasukkan ke HTML halaman saat build, jadi tidak ada di JavaScript sama sekali.
Setelah perubahan ini, 0,3 KB tadi hilang dari semua halaman lain, dan halaman daftar game justru mengecil walaupun bertambah empat game (231,3 KB → 230,6 KB).
4. Uji aturan main sebelum menggambar apa pun
Aturan setiap game ada di file TypeScript biasa tanpa React: cara ubin 2048 bergabung, di mana Minesweeper menaruh ranjau, bagaimana roket di Ship It jatuh. Dengan begitu aturannya mudah diuji sendiri, sebelum ada tampilan apa pun. Cara ini menangkap bug sungguhan:
- Ship It sama sekali tidak punya rintangan. Saat daftar gerbang masih kosong, pengecekan "sudah waktunya gerbang baru?" membandingkan sebuah nilai dengan dirinya sendiri dan tidak pernah terpicu. Pengujian dengan pemain otomatis yang mengetuk setiap kali roket turun terlalu rendah langsung menemukannya. Setelah diperbaiki, pemain otomatis itu melewati 22 sampai 38 gerbang, yang menunjukkan game-nya sulit tapi adil.
- Code Typing Race menampilkan kecepatan yang lebih tinggi dari yang sebenarnya diketik. Rumus live menghitung baris terakhir dua kali di akhir ronde. Sekarang skor akhir dibekukan tepat saat kamu selesai.
- Guess the Stack kadang menawarkan jawaban "salah" yang sebenarnya benar. Sebagian kartu proyek saya menulis "React Query" dan sebagian lagi "TanStack Query", padahal itu library yang sama. Saya menambahkan peta kecil nama teknologi yang artinya sama atau saling menyiratkan (Next.js berarti React, Mongoose berarti MongoDB), lalu membuat 2.000 soal uji untuk memastikan tidak ada pilihan salah yang tumpang tindih dengan stack asli sebuah proyek.
- Merge Conflict tidak pernah kalah di ketukan pertama: ranjau baru ditaruh setelah langkah pertamamu, tidak pernah di sel itu atau di sebelahnya. Pengujian memeriksa ini di ratusan papan.
5. Ponsel bukan urusan belakangan
Kebanyakan orang akan membuka game lewat ponsel, jadi setiap game diuji di ukuran ponsel dengan sentuhan saja:
- Mengusap papan Snake dan 2048 mengarahkan game, bukan menggulir halaman.
- Tombol panah di layar hanya muncul di layar sentuh.
- Minesweeper menandai sel dengan tekan lama, seperti yang biasa dilakukan pemain di ponsel.
- Saat menekan Mulai, halaman bergulir supaya seluruh papan dan kontrolnya terlihat di layar.
- Game berhenti sejenak saat kamu pindah tab atau mengunci ponsel, jadi tidak menguras baterai di latar belakang.
- Code Typing Race terus terang memberi tahu pengguna ponsel bahwa game ini lebih enak dengan keyboard.
Saran untuk siapa pun yang ingin menambah fitur "ekstra" di portofolio
- Tentukan aturan performa lebih dulu, lalu ukur hasilnya. "Rasanya cepat" bukan ukuran.
- Beri setiap fitur ekstra file dan halamannya sendiri. Kalau sebuah fitur hanya ada di satu halaman, kodenya juga hanya boleh dimuat di halaman itu.
- Waspadai file bersama yang diam-diam membesar saat kamu menambah sesuatu.
- Periksa apa yang benar-benar diunduh browser, bukan hanya apa yang dikatakan hasil build.
- Uji logika sebelum tampilan. Kebanyakan bug saya ada di aturan main, bukan di gambarnya.
Membuat game-nya adalah bagian yang seru. Mengukurnya adalah bagian yang paling saya syukuri, karena fitur tambahan ini tidak pernah merugikan orang yang datang untuk melihat portofolio. Coba mainkan salah satunya, dan kalau kamu menemukan bug, saya ingin tahu.
Ingin ngobrol soal ini?
Hubungi saya