Budget-System

Budget management system built with modern web technologies. This repository contains the frontend application with Arabic UI, advanced filters, department budgets, master budget consolidation, reports, and audit logs.

Technologies

• Vite
• TypeScript
• React
• shadcn-ui
• Tailwind CSS

Getting Started

Prerequisites: Node.js and npm installed (you can install via nvm).

Steps:

# 1) Clone the repository
git clone https://github.com/itzzexe/Budget-System.git

# 2) Enter the project directory
cd Budget-System

# 3) Install dependencies
npm i

# 4) Start the development server
npm run dev

Editing the Code

You can use your preferred IDE locally. Commit and push changes to GitHub; CI/CD or deployment steps can be configured as needed.

Deployment

This is a Vite + React app. You can deploy the production build to any static hosting:

npm run build
# Upload the contents of the `dist/` folder to your hosting

Project Structure

• src/components/ — main UI components (DepartmentBudget, MasterBudget, Reports, AuditLogs, etc.)
• src/lib/ — utilities for auth, Excel/PDF handling
• data/ — local JSON data for users, departments, and audit logs

License

Proprietary. Do not distribute without permission.