Skip to content

README.md

Latest commit

 

History

History
139 lines (97 loc) · 3.81 KB

README.md

File metadata and controls

139 lines (97 loc) · 3.81 KB

www.konxc.space - Website Resmi KonXC

Website resmi KonXC yang dibangun menggunakan Astro dan di-deploy ke GitHub Pages.

🌐 Live Site: https://www.konxc.space

📋 Overview

Repository ini berisi source code untuk website resmi KonXC. Website ini dibangun menggunakan:

  • Astro - Static site generator
  • Tailwind CSS - CSS framework
  • pnpm - Package manager
  • GitHub Pages - Hosting platform (manual deployment)

🚀 Quick Start

Prerequisites

  • Node.js (versi 20 atau lebih baru)
  • pnpm: npm install -g pnpm
  • Git

Development

# Clone repository
git clone https://github.com/konxc/konxc.github.io.git
cd konxc.github.io

# Install dependencies
pnpm install

# Start development server
pnpm dev

Website akan tersedia di http://localhost:4321

🧞 Available Commands

Command Action
pnpm install Installs dependencies
pnpm dev Starts local dev server at localhost:4321
pnpm build Build your production site to ./dist/
pnpm preview Preview your build locally, before deploying
pnpm astro ... Run CLI commands like astro add, astro check

🚀 Deployment

⚠️ Important: Manual Deployment Required

Karena masalah billing dengan GitHub Actions, deployment dilakukan secara manual menggunakan script yang telah disediakan.

Branch gh-pages hanya berisi hasil build, tidak ada source code!

Cara Deploy Manual

# Linux/macOS/Windows (Git Bash)
bash ./scripts/deploy-manual.sh

Script akan otomatis:

  1. Pull latest changes dari main
  2. Build project
  3. Deploy hanya hasil build ke branch gh-pages
  4. Push ke GitHub Pages

📚 Dokumentasi Lengkap

Lihat docs/DEPLOY_MANUAL.md untuk dokumentasi deploy yang lebih detail.

🏗️ Project Structure

/
├── public/                 # Static assets
├── src/
│   ├── pages/             # Astro pages
│   └── components/        # Reusable components
├── scripts/               # Deployment scripts
├── docs/                  # Documentation
├── dist/                  # Build output (git ignored)
├── astro.config.mjs       # Astro configuration
├── tailwind.config.js     # Tailwind configuration
└── package.json           # Dependencies

Branch Structure

  • main: Development branch (source code)
  • gh-pages: Deployment branch (build files only)

🔧 Maintenance Guide

Untuk Tim Development

  1. Development Workflow:

    • Buat perubahan di branch main
    • Test lokal dengan pnpm dev
    • Test build dengan pnpm build
    • Deploy menggunakan script manual

  2. Update Content:

    • Edit file di src/pages/ untuk halaman baru
    • Edit file di src/components/ untuk komponen
    • Asset static (gambar, dll) taruh di public/

  3. Styling:

    • Gunakan Tailwind CSS classes
    • Custom CSS bisa ditambahkan di komponen Astro

  4. Deployment Checklist:

    • Pastikan perubahan sudah di-commit di branch main
    • Test build lokal dengan pnpm build
    • Jalankan script deploy manual
    • Verifikasi website di https://www.konxc.space (tunggu 2-5 menit)

Troubleshooting

  • Build Error: Periksa syntax Astro dan dependencies
  • Deploy Error: Pastikan pnpm terinstall dan script executable
  • Website tidak update: Tunggu 2-5 menit, GitHub Pages butuh waktu
  • Lihat dokumentasi lengkap: docs/TROUBLESHOOTING.md

📞 Support

Untuk pertanyaan atau masalah:

  • Periksa dokumentasi di folder docs/
  • Buat issue di repository ini
  • Hubungi tim development

📄 License

Repository ini adalah milik KonXC. Semua hak cipta dilindungi.