IconForge

IconForge is a small web application for creating, editing, and exporting simple icon assets. It is built with Vue 3, TypeScript and Vite. This README gives a quick overview, local development steps, and helpful pointers to the important files in the repository.

You can try it at: iconforge.basselaflak.me

Key features

• Small, responsive UI for editing and previewing icons
• Presets and theme support
• Image processing utilities for exporting icons

Tech stack

• Vue 3 + Composition API
• TypeScript
• Vite (dev server + build)
• Tailwind-like CSS (project-local styling)

Quick start (development)

Prerequisites:

• Node.js (16+ recommended)
• npm or pnpm

Steps:

1. Install dependencies

npm install
# or
# pnpm install

2. Start the dev server

npm run dev

3. Open the app in your browser at the URL printed by Vite (usually http://localhost:5173)

Build for production

npm run build

The built assets will be in the dist/ folder by default.

Important files

• src/main.ts — app entry
• src/App.vue — root component
• src/components/ — UI components
• src/services/imageProcessor.ts — image processing helpers
• public/ — static assets

Localization

The app includes locale files in src/locales/ (for example en.json and ar.json).

Contributing

If you'd like to contribute:

1. Open an issue describing the change or enhancement.
2. Create a branch and a focused pull request.

Suggested developer workflow:

git checkout -b feat/your-feature
# make changes
git add .
git commit -m "feat: short description"
git push origin feat/your-feature

License

This project is licensed under the MIT License — see the LICENSE file in the repository for details.

MIT License
Copyright (c) 2026 IconForge contributors