Files
AURHub/CLAUDE.md
T

2.1 KiB

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

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