Panduan Template Agensi Digital

Panduan ini menjelaskan cara mengubah template menjadi website-mu, lalu mempublikasikannya. Kamu tidak perlu bisa coding. Cukup ikuti langkahnya satu per satu. Read this guide in English.

1. Isi paket

Untuk melihat website-mu kapan saja, klik dua kali index.html. File akan terbuka di browser. Setelah mengedit dan menyimpan, tekan tombol Refresh di browser untuk melihat perubahannya.

2. Persiapan: aplikasi untuk mengedit

index.html adalah file teks biasa. Kamu perlu aplikasi yang bisa mengedit teks apa adanya, bukan aplikasi dokumen seperti Microsoft Word.

Disarankan: Visual Studio Code (gratis)

Unduh di code.visualstudio.com, tersedia untuk Windows dan Mac. Buka aplikasinya, pilih File → Open Folder, lalu pilih folder template ini. Klik index.html di daftar sebelah kiri untuk mengeditnya.

Alternatif tanpa instal

• Windows: klik kanan index.html → Open with → Notepad.
• Mac (TextEdit): buka TextEdit → menu TextEdit → Settings (atau Preferences) → tab Open and Save → centang "Display HTML files as HTML code instead of formatted text". Tanpa pengaturan ini, TextEdit akan merusak file saat disimpan.

Cara mencari teks

Tekan Ctrl+F (Windows) atau Cmd+F (Mac) di aplikasi editor, ketik kata yang kamu lihat di website, dan editor akan melompat ke tempatnya. Ini cara tercepat menemukan apa pun yang ingin diganti.

3. Mulai cepat

Kalau kamu ingin cepat, kerjakan urutan ini. Tiap langkah dijelaskan lengkap di bagian berikutnya.

1. Ekstrak ZIP, klik dua kali index.html untuk melihat tampilan awal.
2. Isi nomor WhatsApp di bagian PENGATURAN.
3. Ganti nama dan teks contoh dengan milikmu.
4. Masukkan foto ke folder foto dan pasang di tempatnya.
5. Pilih bentuk partikel 3D dan atur status proyek di PENGATURAN.
6. Ganti layanan, angka statistik, dan karya dengan milikmu.
7. Sesuaikan warna dengan logomu.
8. Periksa dengan daftar cek, lalu upload ke Netlify atau hosting-mu.

Untuk pemula, siapkan waktu sekitar 1–2 jam, sebagian besar untuk menyiapkan foto.

4. Mengisi nomor WhatsApp

Ini langkah paling penting. Tanpa nomor, tombol "Chat langsung di WhatsApp" dan formulir proyek belum berfungsi.

1. Buka index.html, lalu cari kata PENGATURAN. Letaknya di bagian bawah file.
2. Temukan baris ini:

   nomorWhatsApp: '',

3. Tulis nomormu di antara dua tanda kutip:

   nomorWhatsApp: '0812-3456-7890',

   Format 0812…, +62 812…, dan 62812… semuanya diterima.
4. Simpan, lalu refresh browser. Klik salah satu tombol WhatsApp. WhatsApp akan terbuka dengan pesan yang sudah terisi.

Selama nomor masih kosong, tombol dan formulir hanya menampilkan pengingat. Ini disengaja, supaya pengunjung tidak mengirim pesan ke nomor yang salah.

5. Mengganti teks

Semua nama, harga, cerita, dan ulasan di template ini adalah contoh. Cara termudah: cari teks yang terlihat di website (misalnya Orbitra) dengan Ctrl+F / Cmd+F, lalu ganti.

Yang wajib diganti

Menghapus satu bagian

Setiap bagian diawali komentar seperti <!-- ── KARYA ── -->. Untuk menghapusnya, hapus dari <section di bawah komentar itu sampai </section> pasangannya. Hapus juga tautannya di menu atas (cari href="#karya").

6. Mengganti foto

Kotak berwarna dengan ikon adalah tempat foto. Template ini sengaja tidak menyertakan foto: foto atau mockup karya milikmu sendiri jauh lebih meyakinkan daripada foto stok.

Langkah

1. Simpan fotomu di folder foto. Beri nama huruf kecil tanpa spasi, misalnya karya-aruna.jpg.
2. Di index.html, cari kotak foto yang ingin diganti. Bentuknya seperti ini:

   <div class="foto">
       <svg ...>...</svg>
   </div>

3. Ganti seluruh bagian <svg ...>...</svg> dengan:

   <img src="foto/karya-aruna.jpg" alt="Keterangan singkat foto" />

   Isi alt dengan keterangan singkat. Ini dibaca oleh Google dan pengunjung tunanetra.

Foto otomatis dipotong rapi mengikuti bentuk kotaknya. Label seperti "BARU" di atas foto tetap tampil, jadi biarkan bagian itu ada.

Ukuran foto

• Lebar sekitar 1200–1600 piksel sudah cukup.
• Usahakan setiap foto di bawah 300 KB, supaya website cepat dibuka di HP. Kecilkan gratis di squoosh.app.
• Foto HP biasanya 3–5 MB. Selalu kecilkan dulu.
• Untuk karya, pakai gambar landscape (perbandingan 16:10). Mockup layar atau foto produk dengan latar gelap paling menyatu dengan tema template ini.

7. Dua bahasa

Template ini tampil dalam bahasa Indonesia dan Inggris. Setiap teks ditulis dua kali, berdampingan:

<span lang="id">Layanan</span><span lang="en">Services</span>

Hanya bahasa yang aktif yang tampil. Ganti keduanya setiap kali mengubah teks. Jangan mengubah tanda lang="id" dan lang="en".

Bahasa awal dan tombol ID/EN

• Bahasa awal diatur di baris <html lang="id"> di bagian atas file. Ganti menjadi <html lang="en"> agar pengunjung baru melihat bahasa Inggris.
• Tombol ID/EN di navigasi diatur dengan tombolBahasa: true di PENGATURAN. Pilihan pengunjung diingat di browser mereka.
• Link langsung: tambahkan ?lang=en di akhir alamat (misalnya namausaha.com/?lang=en) untuk membuka versi Inggris. Berguna untuk profil media sosial atau penawaran ke klien luar negeri.

Hanya butuh satu bahasa?

Atur tombolBahasa: false dan pilih bahasanya di <html lang="...">. Teks bahasa lain tetap ada di file tetapi tidak pernah tampil, jadi kamu cukup mengganti teks bahasa yang dipakai.

Teks di dalam atribut

Beberapa teks tidak terlihat langsung di halaman, jadi versi Inggrisnya ditulis sebagai atribut tambahan berawalan data-en:

Status proyek juga punya dua versi di PENGATURAN:

keteranganStatus: { id: 'slot Januari tersisa 2', en: '2 slots left for January' },

8. Halaman, tampilan, dan tema gelap

Menu di atas tidak hanya menggulir: setiap menu membuka halaman sendiri, dengan link sendiri dan transisi yang halus. Semuanya tetap satu file index.html.

Cara halaman dibentuk

• Setiap link di menu atas, misalnya <a href="#layanan">, menjadi satu halaman berisi bagian dengan id itu.
• Bagian yang tidak ada di menu ikut ke halaman sebelumnya. Semua yang ada sebelum bagian menu pertama adalah halaman Beranda.
• Beranda menampilkan kartu ke setiap halaman (Jelajahi), dan setiap halaman ditutup kartu Selanjutnya. Keduanya dibuat otomatis dari menu dan judul <h2> setiap bagian.
• Setiap halaman punya alamat sendiri, misalnya usahamu.com/#layanan. Bagikan di media sosial atau WhatsApp untuk langsung membuka halaman itu.

Menambah atau menghapus halaman

1. Menambah: beri bagian sebuah id (huruf kecil, tanpa spasi), lalu tambahkan link-nya di menu: <a href="#idmu">Nama</a>.
2. Menghapus: hapus link-nya dari menu (bagiannya ikut halaman sebelumnya), atau hapus bagian beserta link-nya.

Satu halaman panjang saja

Isi halamanTerpisah: false di PENGATURAN. Menu kembali menggulir satu halaman panjang.

Tema terang dan gelap

• Tema awal diatur di baris pertama halaman: <html lang="id" data-tema="gelap">. Pilih otomatis (ikut pengaturan HP/komputer pengunjung), terang, atau gelap.
• Tombol matahari/bulan membuat pengunjung bisa mengganti tema, dan pilihannya diingat. Sembunyikan dengan tombolTema: false di PENGATURAN; halaman lalu selalu memakai tema awal.
• Warnamu (--utama) berlaku di kedua tema. Warna tema terang ada di blok CSS bertanda Tema terang / Light theme.

Pengunjung yang menyalakan Kurangi gerakan di perangkatnya tetap mendapat halaman dan tema yang sama, tanpa animasi.

9. Latar 3D dan animasi

Latar partikel di belakang halaman diatur dari PENGATURAN:

efek3D: true,
bentuk3D: 'bola',

• efek3D: false mematikan latar 3D. Cahaya gradasi dan kisi halus tetap tampil.
• Warna partikel mengikuti --utama. Tidak ada yang perlu diubah di kode 3D.
• Di HP jumlah partikel dikurangi supaya tetap lancar. Bila pengunjung memilih kurangi gerakan di perangkatnya, latar 3D tampil diam dan animasi masuk dilewati.

Animasi saat digulir

Judul bagian diberi atribut data-muncul dan muncul dari bawah. Kartu di dalam wadah ber-atribut data-muncul-grup masuk bergantian. Bagian baru yang kamu tambahkan ikut beranimasi bila diberi atribut yang sama. Hapus atributnya untuk bagian yang ingin tampil tanpa animasi.

10. Kartu layanan

Setiap layanan adalah satu blok <div class="kartu-bungkus"> berisi nomor, ikon, nama, keterangan, dan tiga label kecil.

• Mengubah isi: ganti teks di <h3>, <p>, dan baris <li class="tag-kecil">.
• Menambah atau menghapus: salin atau hapus satu blok kartu-bungkus utuh. Enam kartu paling rapi (tiga kolom di layar lebar, dua di tablet). Perbarui juga nomor 01–06.
• Ikon: setiap ikon adalah satu <svg>. Ikon lain bisa diambil gratis di lucide.dev: pilih ikon, salin sebagai SVG, lalu tempel sebagai pengganti <svg>...</svg> di dalam <span class="ikon-layanan">.

Efek miring mengikuti kursor hanya aktif dengan mouse. Di layar sentuh kartu tampil diam supaya mudah digulir.

11. Angka statistik

Setiap angka ditulis seperti ini:

<b class="angka" data-angka="150" data-akhiran="+" data-selesai>150+</b>
<span>Proyek diluncurkan</span>

• data-angka: angka tujuan hitungan, angka saja tanpa titik. Ribuan otomatis diberi titik saat tampil (1500 menjadi 1.500).
• data-akhiran: tanda setelah angka, misalnya +, %, atau jt. Kosongkan (data-akhiran="") bila tidak perlu.
• Teks di antara <b> dan </b> adalah yang tampil bila animasi tidak berjalan. Samakan dengan angka dan akhirannya.

12. Karya

Setiap proyek adalah satu blok <article class="karya">: foto, nama proyek, keterangan singkat, tahun, dan label lingkup kerja.

• Foto: ganti <svg> di dalam <div class="foto lebar"> dengan <img src="foto/karya-aruna.jpg" alt="Aplikasi Aruna Pay" />. Foto sedikit membesar saat disentuh kursor.
• Susunan zig-zag: kartu kedua dan keempat bergeser turun di layar lebar karena kelas md:translate-y-20. Hapus kelas itu untuk susunan rata.
• Menambah: salin satu blok utuh. Jumlah genap paling rapi karena tampil dua kolom.

13. Formulir, email & media sosial

Formulir proyek mengirim satu pesan WhatsApp berisi nama, brand, layanan, anggaran, dan cerita. Pilihan layanan dan anggaran diedit di baris <option> pada <select>-nya, dan kalimat pembuka pesan di data-wa-form="...".

Email dan ikon media sosial mengikuti PENGATURAN:

email: '[email protected]',
sosialMedia: {
	instagram: 'https://www.instagram.com/namastudio',
	linkedin: 'https://www.linkedin.com/company/namastudio',
	dribbble: '',
	behance: '',
	youtube: ''
}

• Tulis link lengkap, diawali https://.
• Kosongkan ('') untuk menyembunyikan ikonnya. Contoh di atas hanya menampilkan Instagram dan LinkedIn.
• Status di bagian pembuka diatur dengan menerimaProyek (true atau false) dan keteranganStatus.

14. Tailwind, Three.js & GSAP

Template ini memakai tiga pustaka yang dimuat dari CDN jsDelivr. Kamu tidak perlu menginstal apa pun:

• Butuh internet. Saat membuka index.html di komputer tanpa internet, halaman tampil polos. Setelah online di hosting, pengunjung memuatnya otomatis.
• Versinya dikunci (misalnya [email protected]) supaya tampilan tidak berubah sendiri saat pustaka diperbarui. Biarkan apa adanya.
• Kelas Tailwind boleh diubah. Misalnya text-lg menjadi text-xl untuk teks lebih besar. Daftar kelasnya ada di tailwindcss.com/docs. Warna tema tersedia sebagai kelas bg-utama, text-aksen, dan sejenisnya.
• Jangan menghapus baris @layer theme, base, upvire, components, utilities; di bagian <style>. Baris itu menjaga kelas Tailwind tetap berlaku.

15. Mengganti warna

Di bagian atas file, cari :root. Ubah dua baris ini dengan kode warna logomu:

--utama: #7c3aed;
--utama-gelap: #6d28d9;

--utama-gelap adalah versi yang sedikit lebih gelap, dipakai saat tombol disentuh. Cari kode warna di Google: color picker. Hindari warna yang terlalu terang untuk --utama, karena teks putih di atasnya sulit dibaca.

Pilihan warna siap pakai

Di halaman demo ada tombol "Coba warna" untuk melihat tiap pilihan. Untuk memakainya, ganti dua baris di :root dengan salah satu pasangan ini:

16. Mempublikasikan website

Sebelum mempublikasikan, lewati dulu daftar cek di bawah.

Pilihan A: Netlify (gratis, paling mudah)

1. Daftar akun gratis di netlify.com.
2. Buka app.netlify.com/drop.
3. Seret seluruh folder template (yang berisi index.html dan folder foto) ke halaman itu.
4. Tunggu beberapa detik. Website-mu langsung online dengan alamat seperti nama-acak.netlify.app. Nama itu bisa kamu ubah di pengaturan situs.

Untuk memperbarui website nanti, seret lagi foldernya di halaman situs tersebut di Netlify (bagian Deploys).

Pilihan B: hosting berbayar dengan cPanel

1. Masuk ke cPanel hosting-mu → File Manager → buka folder public_html.
2. Klik Upload, lalu upload index.html dan folder foto beserta isinya. (Bisa juga upload sebagai ZIP, lalu klik kanan → Extract.)
3. Buka nama domainmu di browser.

PANDUAN.html dan LISENSI.txt tidak perlu di-upload.

Pilihan C: GitHub Pages (gratis)

Cocok kalau kamu sudah punya akun GitHub. Buat repositori publik, upload index.html dan folder foto, lalu di Settings → Pages pilih branch main dan folder / (root).

Memakai domain sendiri

Domain .com, .id, atau .my.id bisa dibeli di penyedia domain mana pun. Di Netlify, buka pengaturan situs → Domain management dan ikuti petunjuknya. Di hosting cPanel, domain biasanya sudah terpasang saat membeli paket.

17. Tampilan saat link dibagikan

Saat link website-mu dibagikan di WhatsApp atau media sosial, yang tampil adalah judul dan deskripsi dari og:title dan og:description di bagian atas file. Ganti keduanya.

Untuk menampilkan gambar juga, siapkan satu foto berukuran sekitar 1200 × 630 piksel, simpan di folder foto, lalu tambahkan baris ini tepat di bawah og:description. Alamatnya harus lengkap, termasuk domainmu:

<meta property="og:image" content="https://domainmu.com/foto/sampul.jpg" />

18. Daftar cek sebelum publikasi

Buka website-mu di browser, lalu periksa satu per satu:

• Nomor WhatsApp sudah diisi dan tombol membuka WhatsApp yang benar.
• Tidak ada lagi nama, alamat, harga, atau rekening contoh.
• Semua foto muncul (tidak ada kotak berikon yang tertinggal).
• Kedua bahasa sudah diganti: klik tombol EN dan periksa tidak ada teks contoh berbahasa Inggris yang tertinggal (atau tombol bahasa sudah dimatikan).
• Angka statistik adalah angka asli studiomu, dan data-angka sama dengan teks yang tertulis.
• Semua karya adalah proyek kamu sendiri, atau klien sudah mengizinkan untuk dipamerkan.
• Status proyek dan email di PENGATURAN sesuai keadaan sekarang.
• Setiap ikon media sosial membuka akun yang benar. Yang tidak dipakai sudah dikosongkan.
• Pilihan layanan di formulir sama dengan kartu layanan, dan satu formulir percobaan sudah dikirim ke dirimu sendiri.
• Latar 3D sudah dicoba di HP: halaman tetap lancar digulir.
• Judul tab browser dan og:title sudah diganti.
• Sudah dicoba dari HP, bukan hanya dari komputer.
• Sudah dicoba dengan meng-klik semua tombol sekali.

19. Jika ada masalah

Mau kami yang pasangkan?

Kalau nggak sempat mengedit sendiri, ada Jasa Pasang + Editing (dibeli terpisah): kami edit template ini sesuai permintaanmu, lalu meng-online-kannya di Netlify paket gratis, di akun atas namamu. Cari Jasa Pasang Website atau Website Setup Service di toko UpVire tempat kamu membeli template ini (Lynk.id, Gumroad, atau Etsy).

Pertanyaan tentang pembelian dan pengunduhan dapat diajukan melalui halaman produk di platform tempat kamu membeli.