Installation

Panduan lengkap untuk menginstal ferzui framework dengan berbagai metode yang tersedia.

Choose Your Installation Method

ferzui dapat diinstal dengan beberapa cara. Pilih metode yang paling sesuai dengan kebutuhan proyek Anda:

🌐

CDN

Perfect untuk prototyping dan proyek kecil

  • ✅ Quick setup
  • ✅ No build process
  • ❌ No tree-shaking
  • ❌ No customization
Use CDN
📦

NPM

Recommended untuk proyek production

  • ✅ Tree-shaking
  • ✅ Customizable
  • ✅ Version control
  • ❌ Requires build process
Use NPM
📁

Download

Untuk proyek tanpa package manager

  • ✅ No dependencies
  • ✅ Offline usage
  • ❌ Manual updates
  • ❌ No tree-shaking
Download Files

CDN Installation

CDN adalah cara tercepat untuk memulai dengan ferzui. Cocok untuk prototyping dan proyek kecil.

Tip: Gunakan CDN untuk development dan prototyping. Untuk production, pertimbangkan menggunakan NPM untuk performa yang lebih baik.

Basic HTML Template

HTML
<!DOCTYPE html>
<html lang="id">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>My ferzui App</title>
  <!-- ferzui CSS -->
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/ferzui@latest/dist/ferzui.css">
</head>
<body>
  <!-- Your content here -->
  <div class="container">
    <h1>Hello ferzui!</h1>
    <button class="btn btn-primary">Click me</button>
  </div>
  
  <!-- ferzui JS -->
  <script src="https://cdn.jsdelivr.net/npm/ferzui@latest/dist/ferzui.js"></script>
</body>
</html>

CDN Links

CDN URLs
<!-- CSS -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/ferzui@latest/dist/ferzui.css">

<!-- JavaScript -->
<script src="https://cdn.jsdelivr.net/npm/ferzui@latest/dist/ferzui.js"></script>

Specific Version

Untuk menggunakan versi tertentu, ganti @latest dengan nomor versi:

Specific Version
<!-- CSS v1.0.0 -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/ferzui@1.0.0/dist/ferzui.css">

<!-- JavaScript v1.0.0 -->
<script src="https://cdn.jsdelivr.net/npm/ferzui@1.0.0/dist/ferzui.js"></script>

NPM Installation

NPM adalah cara yang direkomendasikan untuk proyek production. Memberikan kontrol penuh atas customization dan performa.

Install ferzui

Terminal
# Using npm
npm install ferzui

# Using yarn
yarn add ferzui

# Using pnpm
pnpm add ferzui

# Using bun
bun add ferzui

Import in Your Project

ES Modules

JavaScript
// Import CSS
import 'ferzui/dist/ferzui.css';

// Import JavaScript (optional)
import 'ferzui/dist/ferzui.js';

// Or import specific components
import { Modal, Dropdown, Toast } from 'ferzui';

CommonJS

JavaScript
// Import CSS
require('ferzui/dist/ferzui.css');

// Import JavaScript
require('ferzui/dist/ferzui.js');

Webpack Configuration

webpack.config.js
module.exports = {
  module: {
    rules: [
      {
        test: /\.css$/,
        use: ['style-loader', 'css-loader']
      }
    ]
  }
};

Vite Configuration

vite.config.js
import { defineConfig } from 'vite';

export default defineConfig({
  css: {
    preprocessorOptions: {
      scss: {
        additionalData: `@import "ferzui/src/scss/ferzui.scss";`
      }
    }
  }
});

Download Files

Download file CSS dan JavaScript langsung dari GitHub untuk proyek yang tidak menggunakan package manager.

Download Links

Clone Repository

Terminal
# Clone the repository
git clone https://github.com/FerzDevZ/ferzui.git

# Navigate to the directory
cd ferzui

# Install dependencies (optional)
npm install

# Build the project (optional)
npm run build

Manual Setup

Setelah download, include file CSS dan JavaScript di HTML Anda:

HTML
<!DOCTYPE html>
<html lang="id">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>My ferzui App</title>
  <!-- Include downloaded CSS -->
  <link rel="stylesheet" href="path/to/ferzui.css">
</head>
<body>
  <!-- Your content here -->
  <div class="container">
    <h1>Hello ferzui!</h1>
    <button class="btn btn-primary">Click me</button>
  </div>
  
  <!-- Include downloaded JavaScript -->
  <script src="path/to/ferzui.js"></script>
</body>
</html>

Verification

Pastikan ferzui berhasil diinstal dengan benar:

1

Check CSS Loading

Buka Developer Tools dan periksa apakah CSS ferzui sudah dimuat:

// In browser console
console.log(document.querySelector('link[href*="ferzui"]'));
2

Test Components

Coba buat komponen sederhana:

<button class="btn btn-primary">Test Button</button>
3

Check JavaScript

Pastikan JavaScript ferzui sudah dimuat:

// In browser console
console.log(typeof window.ferzui);

Next Steps

1

Learn Basic Usage

Pelajari cara menggunakan komponen dasar ferzui

Basic Usage
2

Explore Components

Lihat semua komponen yang tersedia

Browse Components
3

Try Live Demo

Coba komponen secara interaktif

Live Demo