Kina-SaQina

🌺 Kina-SaQina

An interactive, modern web experience dedicated to Inoue Takina, crafted with Vue 3, Three.js 3D animations, GSAP, Sass, and Vite.

---

✨ Features

• Interactive 3D Scene: Powered by Three.js for immersive graphics rendering.
• Fluid Animations: Smooth dynamic transitions integrated via GSAP.
• Component Architecture: Modular Vue 3 setup structured with TypeScript for clean maintainability.
• Dockerized: Containerized multi-stage build serving production assets via Nginx.

---

🛠️ Tech Stack

• Framework: Vue 3 (Composition API with <script setup>)
• Build Tool: Vite
• Language: TypeScript
• Graphics & Motion: Three.js, GSAP
• Styling: Sass / SCSS
• Containerization: Docker, Nginx

---

🚀 Quick Start

Prerequisites

Ensure you have the following installed locally:

• Node.js >= 18.0.0
• pnpm or npm

Installation

1. Clone the repository:

   git clone https://github.com/davingm/Kina-SaQina.git
   cd Kina-SaQina
   

2. Install dependencies:

   pnpm install
   # or
   npm install
   

3. Start the local development server:

   pnpm dev
   # or
   npm run dev
   

4. Open your browser and navigate to http://localhost:5173.

Production Build

Build the static distribution files:

pnpm build
# or
npm run build

Preview the production build locally:

pnpm preview
# or
npm run preview

---

🐳 Docker Deployment

Using Docker Compose (Recommended)

Run the containerized application with one command:

docker compose up -d

Access the application at http://localhost:8080.

To stop the container:

docker compose down

Manual Docker Build

1. Build the Docker Image:

   docker build -t kina-saqina:latest .
   

2. Run the Container:

   docker run -d -p 8080:80 --name kina-saqina-app kina-saqina:latest
   

---

🤝 Contributing

Contributions are welcome! Please check out CONTRIBUTING.md to get started.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

Distributed under the GNU General Public License v3.0. See LICENSE for more information.

---

👤 Author

Crafted by @davingm.