zDevTool

Intelligence that scales your workflow.

zDevTool is a high-precision suite of AI-driven utilities designed to eliminate friction in modern development. Built with a minimalist aesthetic and powerful execution, it focuses on rapid prototyping and zero-overhead workflows.

---

🚀 Project Overview

This project is built using the Astro framework, leveraging React for interactive components and Tailwind CSS v4 for high-performance, utility-first styling.

Key Features:

• Astro Framework: Optimized for speed and developer experience.
• Tailwind CSS v4: Modern styling with the latest features.
• Scroll Animations: Smooth "reveal" effects using the Intersection Observer API.
• Hybrid Paradigm: A design philosophy reflecting a high-output human-AI team.
• Engineering Logs: A dedicated section for technical insights and architectural decisions.

---

🛠️ Project Setup

Prerequisites

• Node.js: Version 18.0 or higher.
• npm: Version 9.0 or higher.

Installation

1. Clone the repository:

   git clone <repository-url>
   cd zdevtool

2. Install dependencies:

   npm install

---

💻 Development

To start the development server with hot-module replacement:

npm run dev

The application will be available at http://localhost:3000.

Scripts

• npm run dev: Starts the Astro development server.
• npm run build: Compiles the project for production.
• npm run preview: Previews the production build locally.
• npm run lint: Runs Astro check and TypeScript type checking.
• npm run clean: Removes the dist directory.

---

🏗️ Deployment

1. Build for Production

Generate a static build of the application:

npm run build

The output will be located in the dist/ directory.

2. Deploy to Hosting

Since this is a static site (SSG), you can deploy the contents of the dist/ folder to any static hosting provider:

• Vercel: Connect your repository and it will auto-detect Astro.
• Netlify: Drag and drop the dist/ folder or connect your Git provider.
• GitHub Pages: Use the Astro GitHub Action for automated deployment.
• Cloudflare Pages:
  • Build Command: npm run build
  • Build Output Directory: dist
  • Framework Preset: Astro
• Cloud Run: The project is configured to run on port 3000, making it compatible with containerized environments.

---

📂 Project Structure

├── src/
│   ├── components/    # Reusable UI components (Header, Footer, etc.)
│   ├── layouts/       # Page layouts (Layout.astro)
│   ├── pages/         # Application routes (index.astro, products.astro, etc.)
│   └── styles/        # Global styles and Tailwind configuration
├── public/            # Static assets (images, icons)
├── astro.config.mjs   # Astro configuration
├── package.json       # Dependencies and scripts
└── tsconfig.json      # TypeScript configuration

---

🛡️ License

This project is private and proprietary. All rights reserved.

---

Built by zDevTool — High-precision engineering for the modern web.