adevkit 0.1.0__py3-none-any.whl

adevkit-0.1.0.dist-info/METADATA

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: adevkit
+Version: 0.1.0
+Summary: Aayush's DevKit - Single command project initialisation with agent skills and environments
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: inquirerpy>=0.3.4
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: pydantic>=2.0.0
+
+# ⚡ Aayush's DevKit ⚡
+
+> **One-Command Project Scaffolding with Agentic Skills & Environment Setup**
+
+**Aayush's DevKit** is a fast, interactive developer toolkit CLI designed to initialize production-ready projects in seconds. It handles everything: asking project names, generating tailored codebases, auto-installing curated AI agent skills, creating comprehensive `AGENTS.md` and `PRD.md` documentation, and setting up isolated Python virtual environments, Git, Node packages, and VSCode settings.
+
+---
+
+## 🚀 Features
+
+- **Interactive Terminal UI**: Built with `Typer`, `Rich`, and `InquirerPy` featuring branded ASCII art, arrow-key navigation, live progress spinners, and status tables.
+- **10 Built-In Project Starters**:
+  1. `nextjs`: Full-Stack Next.js 14/15 App Router, React 19, TypeScript, Tailwind CSS, Lucide Icons, and shadcn-ready layout.
+  2. `saas_fullstack`: Production-grade SaaS starter with Next.js 15, Prisma ORM, Stripe subscriptions, and Auth.
+  3. `design_system`: Tokenized UI component library with Framer Motion, accessible primitives, and interactive showcase.
+  4. `content_site`: Blazing-fast content and marketing website with Astro 4, Tailwind Typography, and zero JS by default.
+  5. `python_fastapi`: Modern async Python backend with FastAPI, Pydantic v2, Typer CLI, and automated `.venv` & pytest.
+  6. `ai_agents_python`: Asynchronous multi-agent framework starter with state graphs, memory, and FastAPI endpoints.
+  7. `vite_react`: Ultra-fast Frontend SPA with Vite 5, React 18, TypeScript, and Tailwind CSS.
+  8. `minimal_agentic`: Clean blank repository with agent tools, `AGENTS.md`, and `PRD.md` ready for AI pair programming.
+  9. `expo_mobile`: Cross-platform mobile starter with React Native, Expo SDK, and TypeScript.
+  10. `expo_fullstack`: Monorepo with Expo React Native mobile `frontend/` and selectable `backend/` (FastAPI or Node.js Hono).
+- **Custom Template Engine**:
+  - `devkit template save <NAME>`: Snapshot any existing directory or repo into reusable custom templates saved in `~/.aayush-devkit/templates/`.
+  - `devkit template list`: View all built-in and custom templates.
+  - `devkit template delete <NAME>`: Cleanly remove saved templates.
+- **42 Embedded Curated Agent Skills**:
+  - Direct, 100% offline access to all curated skills with automatic `.agents/skills/` population and valid `skills-lock.json` generation.
+  - Sourced from top engineering leaders:
+    - **`pbakaus/impeccable`**: Design craftsmanship, typography hierarchy, spacing & layout polish.
+    - **`Leonxlnx/taste-skill` (`design-taste-frontend`)**: Aesthetic taste, anti-generic UI, distinctive art direction & color harmony.
+    - **`DietrichGebert/ponytail`**: `ponytail`, `ponytail-audit`, `ponytail-review`, `ponytail-debt`, `ponytail-gain`, `ponytail-help`.
+    - **`vercel-labs/agent-skills`**: `vercel-react-best-practices`, `vercel-composition-patterns`, `vercel-optimize`, `deploy-to-vercel`, `vercel-react-view-transitions`.
+    - **`nextlevelbuilder/ui-ux-pro-max-skill`**: `ui-ux-pro-max`, `design`, `design-system`, `ui-styling`, `brand`, `banner-design`, `slides`.
+    - **`emilkowalski/skills`**: `emil-design-eng`, `animate`, `animate-expo`, `animation-performance`, `apple-design`, `break-ui`, `improve-animations`, `mobile-native`.
+- **Automated Environment Setup**:
+  - **Python**: Creates `.venv` using active Python interpreter, installs `requirements.txt`.
+  - **Node.js**: Automatically detects `bun`, `pnpm`, `yarn`, or `npm` and installs `node_modules`.
+  - **Git**: Initializes repository and crafts stack-tailored `.gitignore`.
+  - **Environment**: Copies `.env.example` to `.env` without overwriting.
+  - **VSCode**: Scaffolds `.vscode/settings.json` and `.vscode/extensions.json`.
+- **Intelligent Documentation**:
+  - **`AGENTS.md`**: Injects tailored guidelines for AI assistants (Antigravity, Cursor, Claude Code, Gemini CLI), including anti-generic design rules and Vercel Server Component patterns when relevant skills are selected.
+  - **`PRD.md`**: Guided prompt wizard, standardized comprehensive starter, or path-based import.
+
+---
+
+## 📦 Quick Start
+
+### 1. Install via PyPI (Recommended)
+```bash
+pip install adevkit
+```
+Now run `devkit` or `adevkit` anywhere in your terminal:
+```bash
+devkit init
+```
+
+### 2. Windows Native MSI Installer
+Download and execute `AayushsDevKit-v0.1.0-x64.msi` from the [Releases](https://github.com/aayush/aayush-devkit/releases) tab. It automatically adds `devkit` to your system `PATH`.
+
+### 3. Run Directly from Source
+```powershell
+python app.py
+```
+Or with Windows command script:
+```powershell
+.\devkit.cmd
+```
+
+---
+
+## 🛠 Commands
+
+### Initialize a New Project
+```powershell
+# Interactive wizard
+devkit init
+
+# Specify name and target directory
+devkit init my-saas -t saas_fullstack
+
+# Non-interactive / CI mode
+devkit init my-app -t nextjs -s ponytail -s impeccable -s design-taste-frontend --yes
+```
+
+### Manage Custom Templates
+```powershell
+# Snapshot current folder as a reusable template
+devkit template save my-starter --desc "Company internal microservice"
+
+# Snapshot specific folder
+devkit template save my-starter --path "C:\path\to\project"
+
+# List all available templates (built-in and custom)
+devkit template list
+
+# Delete a custom template
+devkit template delete my-starter
+```
+
+### Manage Agent Skills
+```powershell
+# List curated skill catalog
+devkit skills list
+
+# Install a skill into the current project
+devkit skills add impeccable
+
+# Sync and reload skills catalog
+devkit skills update
+```
+
+### System Diagnostics
+```powershell
+devkit info
+```
+
+---
+
+## 🧪 Running Tests
+
+The test suite covers all 10 templates, custom template snapshots, skills installation, lockfile verification, and environment setup:
+
+```powershell
+.\.venv\Scripts\pytest.exe tests/ -v
+```
+
+---
+
+## 🚀 CI/CD & Automated MSI Release
+
+This repository includes a dedicated GitHub Actions workflow ([`.github/workflows/release.yml`](.github/workflows/release.yml)) that automates building and releasing the application.
+
+### Pipeline Workflow:
+1. **Quality Gate**: Runs the full `pytest` suite on `windows-latest`.
+2. **PyInstaller Compilation**: Builds a self-contained `devkit.exe` bundling all 42 agent skills and templates (target machines require zero Python setup).
+3. **WiX MSI Installer Packaging**: Uses WiX Toolset to produce `AayushsDevKit-v<version>-x64.msi`, which installs to `Program Files` and **configures the system `PATH` environment variable**.
+4. **PyPI Publishing (`adevkit`)**: Builds wheel & source tarball, and publishes automatically to PyPI via `pypa/gh-action-pypi-publish` using the GitHub secret `PYPI_API_TOKEN`.
+5. **Portable Zip & SHA256 Checksums**: Compresses `devkit.exe` into a portable `.zip` and generates `SHA256SUMS.txt`.
+6. **GitHub Release Publication**: Automatically publishes the release under the version tag specified in `pyproject.toml` (e.g., `v0.1.0`) with `.msi`, `.zip`, `.whl`, `.tar.gz`, and checksums.
+
+### Prerequisites for PyPI Publishing:
+Add your PyPI API token to your GitHub repository secrets:
+- Name: **`PYPI_API_TOKEN`**
+- Value: `pypi-AgEIcHlwaS5vcmc...` (Generated from [pypi.org/manage/account/token/](https://pypi.org/manage/account/token/))
+
+### Triggering a Release:
+- **Pushing a tag**:
+  ```powershell
+  git tag v0.1.0
+  git push origin v0.1.0
+  ```
+- **Manual Dispatch**: Go to the **Actions** tab on GitHub, select **Build & Release Aayush's DevKit**, and click **Run workflow**.
+
+---
+
+## 📄 License
+MIT © Aayush