Digital Agency Template Guide

This guide shows you how to turn the template into your own website and publish it. No coding skills needed: follow the steps one at a time. Baca dalam bahasa Indonesia.

1. What is in the package

To look at your website at any time, double-click index.html and it opens in your browser. After editing and saving, press Refresh in the browser to see the change.

2. Indonesian words in the code

UpVire is an Indonesian studio, so the names inside the code are Indonesian. You never need to rename them, and every setting has an English comment next to it. The words you will meet most:

Comments in the file are written in both languages, Indonesian first and English on the next line.

3. Getting ready: an app to edit with

index.html is a plain text file. You need an app that edits text as-is, not a word processor like Microsoft Word.

Recommended: Visual Studio Code (free)

Download it from code.visualstudio.com (Windows, Mac and Linux). Open the app, choose File → Open Folder, and pick the template folder. Click index.html in the list on the left to edit it.

Without installing anything

• Windows: right-click index.html → Open with → Notepad.
• Mac (TextEdit): open TextEdit → TextEdit → Settings (or Preferences) → Open and Save tab → tick "Display HTML files as HTML code instead of formatted text". Without this setting TextEdit damages the file when saving.

Finding text

Press Ctrl+F (Windows) or Cmd+F (Mac) in your editor and type a word you see on the website. The editor jumps straight to it. This is the fastest way to find anything you want to change.

4. Quick start

If you are in a hurry, work through this list. Each step is explained in full further down.

1. Unzip the file and double-click index.html to see the starting point.
2. Fill in your WhatsApp number, with country code, under PENGATURAN.
3. Choose the default language, and whether visitors can switch.
4. Replace the name and sample text with your own.
5. Put your photos in the foto folder and link them.
6. Choose the 3D particle shape and set your project status in PENGATURAN.
7. Replace the services, stats and projects with your own.
8. Match the colours to your brand.
9. Go through the checklist, then upload to Netlify or your web host.

Allow about 1–2 hours if you are new to this, most of it spent preparing photos and writing your own text.

5. WhatsApp number

This is the most important step. Without a number, the "Chat with us on WhatsApp" button and the project form do not work yet.

1. Open index.html and search for PENGATURAN (Indonesian for "settings"). It is near the bottom of the file.
2. Find this line:

   nomorWhatsApp: '',

3. Type your number between the two quote marks, starting with your country code:

   nomorWhatsApp: '+44 7700 900123',

   Spaces, dashes and the + are fine: only the digits are used.
4. Save, then refresh the browser. Click one of the WhatsApp buttons: WhatsApp opens with the message already typed.

While the number is empty, the buttons and form only show a reminder. This is on purpose, so no visitor messages a wrong number.

6. Replacing the text

Every name, number, story and project in this template is an example. The easiest way to replace them: search for the text you see on the website (for example Orbitra) with Ctrl+F / Cmd+F, then replace it.

Must replace

Removing a section

Each section starts with a comment such as <!-- ── KARYA / WORK ── -->. To remove it, delete from the <section below that comment to its matching </section>. Also remove its menu links (search for href="#karya").

7. Replacing the photos

The coloured boxes with an icon are photo placeholders. The template ships without photos on purpose: photos or mockups of your own work are far more convincing than stock images.

Steps

1. Save your photos in the foto folder. Use lowercase names without spaces, for example project-aruna.jpg.
2. In index.html, find the photo box you want to replace. It looks like this:

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

3. Replace the whole <svg ...>...</svg> part with:

   <img src="foto/project-aruna.jpg" alt="Short description of the photo" />

   Fill in alt with a short description. Google and screen readers use it.

The photo is cropped neatly to the shape of its box automatically.

Photo size

• About 1200–1600 pixels wide is plenty.
• Keep each photo under 300 KB so the site loads fast on phones. Compress for free at squoosh.app.
• Phone photos are usually 3–5 MB. Always compress them first.
• For projects, use landscape images (16:10). Screen mockups or product shots on a dark background blend best with this template.

8. Two languages

This template shows in Indonesian and English. Every text is written twice, side by side:

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

Only the active language is shown. Edit both whenever you change a text, and never change the lang="id" and lang="en" markers themselves.

Default language and the ID/EN switch

• The default language is set on the <html lang="id"> line at the top of the file. Change it to <html lang="en"> so new visitors see English first.
• The ID/EN switch in the navigation is controlled by tombolBahasa: true in PENGATURAN. A visitor's choice is remembered in their browser.
• Direct link: add ?lang=en (or ?lang=id) to the end of your address, e.g. yourbusiness.com/?lang=en, to open a specific language. Handy in proposals and social profiles.

English only?

This is the most common setup outside Indonesia:

1. Change the top line to <html lang="en">.
2. Set tombolBahasa: false in PENGATURAN. The switch disappears.
3. Edit only the lang="en" texts and the data-en... attributes. The Indonesian texts stay in the file but never show, so you can leave them as they are.

You can use any other second language the same way: write it in the lang="id" slots and relabel the switch button (the ID text inside id="pilih-bahasa").

Text inside attributes

Some text is not shown directly on the page, so its English version is an extra attribute starting with data-en:

The project status also has two versions in PENGATURAN:

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

9. Pages, look and dark theme

The menu at the top does not just scroll: each menu item opens its own page, with its own link and a smooth transition. It is still one index.html file, so everything you edit stays in one place.

How the pages are made

• Every link in the top menu, e.g. <a href="#layanan">, becomes a page made of the section with that id.
• A section that is not in the menu joins the page before it. Everything before the first menu section is the Home page.
• The Home page lists every page as a card (Explore), and each page ends with a Next card. Both are made automatically from the menu and each section's <h2> heading.
• Each page has its own address, e.g. yourbusiness.com/#layanan. Share it on social media or in a WhatsApp message to open that page directly.

Adding or removing a page

1. To add one: give a section an id (lowercase, no spaces) and add a link to it in the menu: <a href="#yourid">Name</a>.
2. To remove one: delete its link from the menu (the section then joins the page before it), or delete the section and its link.

One long page instead

Set halamanTerpisah: false in PENGATURAN. The menu then scrolls down one long page, as on a classic one-page website.

Light and dark theme

• The default theme is set on the first line of the page: <html lang="id" data-tema="gelap">. Use otomatis to follow the visitor's phone or computer setting, terang for light, or gelap for dark.
• The sun/moon button lets visitors switch, and remembers their choice. Hide it with tombolTema: false in PENGATURAN; the page then always uses the default theme.
• Your colours (--utama) work in both themes. The light theme’s colours are in the CSS block marked Tema terang / Light theme.

Visitors who turned on Reduce motion on their device get the same pages and themes without the animations.

10. 3D background and animation

The particle background behind the page is set in PENGATURAN:

efek3D: true,
bentuk3D: 'bola',

• efek3D: false turns the 3D background off. The gradient glow and subtle grid stay.
• The particle colour follows --utama. Nothing to change in the 3D code.
• Phones get fewer particles so the page stays smooth. When a visitor turns on Reduce motion on their device, the 3D background stays still and the entrance animations are skipped.

Scroll animations

Section headings with the data-muncul attribute rise into view. Cards inside a container with data-muncul-grup come in one after another. New sections animate too if you give them the same attribute; remove it for anything that should appear without animation.

11. Service cards

Each service is one <div class="kartu-bungkus"> block (kartu = card) with a number, icon, name, description and three small tags.

• Changing the content: edit the text in <h3>, <p> and the <li class="tag-kecil"> lines, in both languages.
• Adding or removing: copy or delete one whole kartu-bungkus block. Six cards look best (three columns on wide screens, two on tablets). Update the numbers 01–06 too.
• Icons: each icon is one <svg>. Get other icons free at lucide.dev: pick one, copy it as SVG, and paste it in place of the <svg>...</svg> inside <span class="ikon-layanan">.

The tilt effect only works with a mouse. On touch screens the cards stay still so scrolling is easy.

12. Stats

Each number is written like this:

<b class="angka" data-angka="150" data-akhiran="+" data-selesai>150+</b>
<span>...Projects launched...</span>

• data-angka (angka = number): the number to count up to, digits only. Thousands get separators automatically: 1,500 in English and 1.500 in Indonesian.
• data-akhiran (akhiran = suffix): the sign after the number, e.g. +, % or k. Leave it empty (data-akhiran="") if not needed.
• The text between <b> and </b> is what shows if the animation does not run. Keep it the same as the number and suffix.

13. Work

Each project is one <article class="karya"> block (karya = work): photo, project name, short description, year and scope tags.

• Photo: replace the <svg> inside <div class="foto lebar"> with <img src="foto/project-aruna.jpg" alt="Aruna Pay app" />. The photo zooms slightly on hover.
• Zig-zag layout: the second and fourth cards sit lower on wide screens because of the md:translate-y-20 class. Remove it for an even grid.
• Adding: copy one whole block. Even numbers look best, since there are two columns.

14. Form, email & social media

The project form sends one WhatsApp message with the name, brand, service, budget and story, in the language the visitor is viewing. Edit the service and budget choices in the <option> lines, and the opening sentence in data-wa-form / data-en-wa-form.

The email and social icons follow PENGATURAN:

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

• Write full links, starting with https://.
• Leave one empty ('') to hide its icon. The example above only shows Instagram and LinkedIn.
• The hero status uses menerimaProyek (true = taking projects, false = fully booked) and keteranganStatus.

15. Tailwind, Three.js & GSAP

This template uses three libraries loaded from the jsDelivr CDN. Nothing to install:

• Needs internet. Opening index.html offline shows an unstyled page. Once hosted, visitors load the libraries automatically.
• Versions are pinned (e.g. [email protected]) so the page never changes when a library updates. Leave them as they are.
• You can change Tailwind classes, e.g. text-lg to text-xl for bigger text. All classes are listed at tailwindcss.com/docs. The theme colours work as classes too: bg-utama, text-aksen and so on.
• Do not delete the line @layer theme, base, upvire, components, utilities; in the <style> block. It keeps the Tailwind classes working.

16. Changing the colours

Near the top of the file, find :root. Change these two lines to your brand colour (utama means primary, gelap means dark):

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

--utama-gelap is a slightly darker shade, used for gradients and hover states. Find colour codes with Google: color picker. Avoid very light colours for --utama, because white text on top of it becomes hard to read.

17. Publishing your website

Before publishing, go through the checklist below.

Option A: Netlify (free, easiest)

1. Create a free account at netlify.com.
2. Go to app.netlify.com/drop.
3. Drag the whole template folder (the one with index.html and the foto folder) onto the page.
4. Wait a few seconds. Your site is online at an address like random-name.netlify.app, which you can rename in the site settings.

To update the site later, drag the folder again onto that site's Deploys page in Netlify.

Option B: a web host with cPanel

1. Log in to cPanel → File Manager → open public_html.
2. Click Upload and upload index.html and the foto folder with its contents. (Or upload a ZIP, then right-click → Extract.)
3. Open your domain in the browser.

The guides and licence files do not need to be uploaded.

Option C: GitHub Pages (free)

Handy if you already have a GitHub account. Create a public repository, upload index.html and the foto folder, then under Settings → Pages choose the main branch and the / (root) folder.

Using your own domain

Buy a domain from any registrar (Namecheap, Cloudflare, Porkbun and many others). In Netlify, open the site settings → Domain management and follow the steps. With cPanel hosting, the domain is usually connected when you buy the plan.

18. How the link looks when shared

When your link is shared on WhatsApp, LinkedIn or other social media, the preview shows the title and description from og:title and og:description near the top of the file. Replace both. These two do not switch language, so write them in the language of your main market.

To show an image too, prepare a picture of about 1200 × 630 pixels, save it in the foto folder, and add this line right below og:description. The address must be complete, including your domain:

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

19. Checklist before publishing

Open your website in the browser and check each item:

• The WhatsApp number is filled in with a country code, and the buttons open the right chat.
• No sample names, addresses, prices or numbers are left, in both languages (or the language switch is off).
• All photos show (no placeholder boxes left).
• The stats are your real numbers, and each data-angka matches the text written next to it.
• Every project is your own work, or the client agreed to have it shown.
• The project status and email in PENGATURAN are up to date.
• Every social icon opens the right account, and unused ones are emptied.
• The service options in the form match the service cards, and you sent yourself one test message.
• The 3D background was tried on a phone: the page still scrolls smoothly.
• The browser tab title and og:title are replaced.
• Tested on a phone, not just a computer.
• Every button clicked at least once.

20. If something goes wrong

Want us to set it up?

If you'd rather not edit it yourself, there is a Website Setup Service (sold separately): we edit this template to your brief and put it online on Netlify's free plan, in an account in your name. Look for Website Setup Service in the UpVire shop where you bought this template (Gumroad, Etsy or Lynk.id).

Questions about your purchase or download can be sent through the product page on the platform where you bought it.