Initial commit: ArchStore package manager for Arch Linux

CLAUDE.md

@@ -0,0 +1,166 @@
+# CLAUDE.md
+
+# Project Name
+ArchStore
+
+# Project Description
+ArchStore is a lightweight modern package store for Arch Linux.
+It combines official pacman repositories and the AUR into one clean interface similar to a Play Store.
+
+Users can:
+- Search packages
+- Install packages
+- View package details
+- Check updates
+- Browse categories
+- Analyze package security
+
+---
+
+# Goals
+- Fast and lightweight
+- Modern UI
+- Secure package installation
+- Unified package ecosystem
+- Beginner friendly
+- Open source
+
+---
+
+# Core Features
+
+## Package Search
+Search packages from:
+- pacman repositories
+- AUR repositories
+
+---
+
+## Package Information
+Show:
+- package name
+- description
+- maintainer
+- dependencies
+- version
+- popularity
+- votes
+- package size
+- last updated
+
+---
+
+## One Click Install
+Install packages using:
+- pacman
+- paru
+
+---
+
+## Update Center
+Show available package updates.
+
+---
+
+## Security Scanner
+Analyze PKGBUILD files for:
+- dangerous bash commands
+- suspicious scripts
+- hidden downloads
+- obfuscated code
+- remote execution attempts
+
+---
+
+# Tech Stack
+
+## Frontend
+- React
+- TailwindCSS
+- Vite
+
+## Backend
+- Python
+- FastAPI
+
+## Database
+- SQLite
+
+---
+
+# APIs
+
+## AUR RPC
+https://aur.archlinux.org/rpc/
+
+---
+
+# Backend Structure
+
+backend/
+├── api/
+├── scanner/
+├── services/
+├── database/
+├── main.py
+
+---
+
+# Frontend Structure
+
+frontend/
+├── src/
+├── components/
+├── pages/
+├── layouts/
+├── services/
+
+---
+
+# UI Style
+- Dark theme
+- Minimal interface
+- Fast navigation
+- Responsive design
+
+---
+
+# Future Features
+- AI malware detection
+- Verified packages
+- Package reviews
+- Package screenshots
+- Dependency graph
+- Flatpak support
+- Snap support
+- Electron desktop client
+
+---
+
+# Security Rules
+- Never execute unknown scripts directly
+- Always sanitize shell commands
+- Validate package metadata
+- Use sandboxed package analysis
+- Prevent command injection
+
+---
+
+# Development Commands
+
+## Backend
+uvicorn main:app --reload
+
+## Frontend
+npm run dev
+
+---
+
+# Project Vision
+Create the best lightweight package store experience for Arch Linux users.
+
+---
+
+# Maintainer
+Aur & Arch 5t4l1n
+github:0x5t4l1n