Installation Guide

Follow these steps to set up and start using the theme.

Prerequisites

Before you begin, ensure your system meets the following requirements.

Tip

If you’re on macOS, the easiest way to install dependencies is using Homebrew. Homebrew is a package manager that simplifies installing software. Follow this guide to install Homebrew.

Install Node.js

Looka requires Node.js (LTS version) to work. Node.js lets you run JavaScript code on your computer. Here’s how to install it based on your operating system:

Windows

Follow these steps to install Node.js on Windows:

1. Download the latest LTS version of Node.js from the official website: Node.js Downloads
2. Run the installer after it’s downloaded, and follow the on-screen instructions. The installer will guide you through the process.
3. After installation, open the Command Prompt (search for “cmd” in the Start menu) and verify the installation by typing the following command and pressing Enter:

node -v

If Node.js was installed correctly, you’ll see the version number (e.g., v22.13.1). This confirms that Node.js is ready to use!

Tip

If you run into any issues, you can use Chocolatey (a Windows package manager) to install Node.js. Open the Command Prompt and run:

choco install nodejs-lts

macOS

Here’s how to install Node.js on macOS:

1. First, make sure you have Homebrew installed. Homebrew is a tool that makes installing software easy. If you don’t have it, follow this guide to install it.
2. Open your Terminal (you can find it in Applications > Utilities) and run this command to install Node.js:

brew install node

3. After installation, verify Node.js by typing the following command:

node -v

If everything is set up, the terminal will display the installed version of Node.js.

Tip

If you prefer, you can also download the installer directly from the official Node.js Downloads page instead of using Homebrew.

Linux

To install Node.js on Linux, follow these steps:

1. Open your Terminal and update your package list:

sudo apt update

2. Install Node.js using your package manager:

sudo apt install nodejs

3. Optionally, install npm (Node.js package manager) by running:

sudo apt install npm

4. Verify the installation by typing:

node -v

The installed version of Node.js will be displayed if everything worked correctly.

Tip

For other Linux distributions, check the official Node.js installation guide for additional instructions.

💡 Need help? Check out the official Node.js installation guide.

---

Setting Up Looka

Once Node.js is installed, follow these steps to set up Looka:

Install Dependencies

Navigate to your project directory (the main theme folder) and run:

npm install

This will install all the necessary dependencies for Looka.

Start the Development Server

To start the local development server and view your site on your computer, run:

npm run dev

🔹 Your site will be available at http://localhost:4321 (or the customized port). That’s a solid start! If you want to add a bit more context or guidance, you could expand it like this:

Create a Production Build

To generate an optimized production build of your site, run the following command in your project root:

npm run build

This will compile your project, optimize assets, and prepare everything for deployment. The output will be located in the dist/ folder by default.

Preview the Production Build

To see how your site will look in the final production version, run:

npm run preview

This allows you to preview how the theme will look once it’s live on the internet.

---

🚀 You’re all set! Now you can start customizing Looka to fit your needs. 🎨