@christianliebel/paint

Paint: An open-source, Web Components-based remake of MS Paint using modern web capabilities

Paint is back—right in your browser! Try it on paint.js.org.

This project aims to demonstrate modern web capabilities and Web Component-based application architectures on the example of a productivity app dinosaur: Paint. All offline-capable and installable, just as Progressive Web Apps should be.

PLEASE NOTE

This project is in an early state. Not all tools and actions are implemented right now. Your help and feedback are wanted!

Modern Web Technology

This project demonstrates the use of:

• Web Components, the built-in component model of the web (via Lit)
• Service Workers for offline capability (via Workbox)
• Web App Manifest for installability
• File System Access API for file system access (via browser-fs-access), including drag and drop
• File Handling API for registering as a handler for *.png files
• Async Clipboard API for clipboard access
• Web Share API for sharing images to other applications via File > Send…
• StorageManager API for estimating storage usage in Help > About Paint
• prefers-color-scheme for dark mode
• Local Font Access API for accessing local fonts
• Vite, a lightning-fast frontend build tool

Goals

• This implementation tries to stick as closely as possible to the original Paint for Windows 95—not more, but also not less. You might want to check out Felix Rieseberg’s windows95 to run the original Paint.
• This implementation should stay smaller (= transferred bytes) than Paint’s executable size of 340K.
• Everything must be achieved with web technology only, so no Cordova/Capacitor or Electron/Tauri builds. Features that are not exposed to the web must be disabled in the menu.
• Where modern web APIs are used, they should be progressively enhanced.

Setup

1. Clone this repository
2. Run npm i
3. Run npm start
4. Done!

Using the Web Component

Paint is available as a web component, so you can easily embed it into other applications or websites.

1. Install the library
   • Download the npm package @christianliebel/paint and register the elements by importing the library: import '@christianliebel/paint';
   • Alternatively, use a service like unpkg.com: <script src="https://unpkg.com/@christianliebel/paint/dist/elements/index.js" type="module"></script>
2. Use the <paint-app> component in your application.
3. Optional: If you want to react to changes of the document title, listen to the titlechange event. You can find the updated title in the event.details.title property.
4. Done!

Wait, I’ve seen this before

You’re right! The awesome JSPaint (GitHub) has been around for a long time and is, by far, more complete. In contrast to JSPaint, this project is offline-capable and makes use of modern web platform APIs.

License

This project is provided for educational purposes only. It is not affiliated with and has not been approved by Microsoft.

Changelog

1.3.0 (2024-05-16)

Features

• add file handler icon (a817e21), closes #568
• e2e: migrate to Cypress 10 (6d3e99a)
• elements: add throttledPointerMove method to Canvas class (0a5cdbd)
• helpers: bring back Local Font Access API (63c8f8f)
• index.html: reference files in public folder (698e96c)
• tools: implement ellipse tool (468166c), closes #27

Bug Fixes

• custom-elements: update manifest to match spec (bf03dd5)
• do not process manifest (ed04e36)
• edit: fix copy command for Safari (13c4d52)
• elements: update app.ts - fix bug with z-index (e58e653)
• expose Vite port locally (9ad8b31)
• menus: cast to unknown as FileSystemHandle types don’t overlap (3e96547)
• tools: fix TypeScript errors after migration to TS 5 (f2341e0)
• update default ports to Vite’s 5173 (d942ccd)
• use built-in FileSystemHandle types (179e6a0)