mirror of
				https://github.com/excalidraw/excalidraw.git
				synced 2025-11-04 04:44:31 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			100 lines
		
	
	
		
			5.4 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			100 lines
		
	
	
		
			5.4 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
<div align="center" style="display:flex;flex-direction:column;">
 | 
						|
  <a href="https://excalidraw.com">
 | 
						|
    <img src="./public/og-image.png" alt="Excalidraw logo: Sketch handrawn like diagrams." />
 | 
						|
  </a>
 | 
						|
  <h3>Excalidraw is a whiteboard tool that lets you easily sketch diagrams that have a hand-drawn feel to them.</h3>
 | 
						|
  <a href="https://twitter.com/Excalidraw">
 | 
						|
    <img alt="Follow Excalidraw on Twitter" src="https://img.shields.io/twitter/follow/excalidraw.svg?label=follow+excalidraw&style=flat-square&logo=twitter">
 | 
						|
  </a>
 | 
						|
</div>
 | 
						|
 | 
						|
## Try it now
 | 
						|
 | 
						|
[](https://app.netlify.com/sites/excalidraw/deploys)
 | 
						|
 | 
						|
Go to https://excalidraw.com to start sketching
 | 
						|
 | 
						|
## Testimonials
 | 
						|
 | 
						|
<a href="https://twitter.com/Lissy_Sykes/status/1213813117177729026"><img width="398" src="https://user-images.githubusercontent.com/197597/71783813-dbf8a600-2fa0-11ea-9c0d-bb3cc45969e6.png"></a>
 | 
						|
 | 
						|
<a href="https://twitter.com/dan_abramov/status/1213762494428262400"><img width="398" src="https://user-images.githubusercontent.com/197597/71783990-4d395880-2fa3-11ea-9ad7-186138db5003.png"></a>
 | 
						|
 | 
						|
<a href="https://twitter.com/kyehohenberger/status/1214288572037025792"><img width="423" src="https://user-images.githubusercontent.com/197597/71851802-34f13880-308c-11ea-9416-191099e6349c.png"></a>
 | 
						|
 | 
						|
<a href="https://twitter.com/jordwalke/status/1214858186789806080"><img width="434" src="https://user-images.githubusercontent.com/197597/72036874-07a1b780-3251-11ea-99e8-6bafd93483a0.png"></a>
 | 
						|
 | 
						|
<a href="https://twitter.com/lucasazzola/status/1215126440330416128"><img width="429" src="https://user-images.githubusercontent.com/197597/72039003-48e99580-3258-11ea-8daa-85dd055f2a82.png">
 | 
						|
 | 
						|
## Run the code
 | 
						|
 | 
						|
### Code Sandbox
 | 
						|
 | 
						|
- Go to https://codesandbox.io/s/github/excalidraw/excalidraw
 | 
						|
- You can start coding instantly, and even send PRs from there!
 | 
						|
 | 
						|
### Local Installation
 | 
						|
 | 
						|
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
 | 
						|
 | 
						|
#### Clone the repo
 | 
						|
 | 
						|
```bash
 | 
						|
git clone https://github.com/excalidraw/excalidraw.git
 | 
						|
```
 | 
						|
 | 
						|
#### Commands
 | 
						|
 | 
						|
| Command             | Description                       |
 | 
						|
| ------------------- | --------------------------------- |
 | 
						|
| `npm install`       | Install the dependencies          |
 | 
						|
| `npm run start`     | Run the project                   |
 | 
						|
| `npm run fix`       | Reformat all files with Prettier  |
 | 
						|
| `npm run test:code` | Test for formatting with Prettier |
 | 
						|
| `npm run test:app`  | Test the app                      |
 | 
						|
| `npm run test`      | Run all tests                     |
 | 
						|
 | 
						|
## Contributing
 | 
						|
 | 
						|
Pull requests are welcome. For major changes, please open an [issue](https://github.com/excalidraw/excalidraw/issues) first to discuss what you would like to change.
 | 
						|
 | 
						|
You can also discuss the app on our [Gitter channel](https://gitter.im/excalidraw/community).
 | 
						|
 | 
						|
## Excalidraw is built using these awesome tools
 | 
						|
 | 
						|
- [React](https://reactjs.org)
 | 
						|
- [Rough.js](https://roughjs.com)
 | 
						|
- [Netlify](https://www.netlify.com)
 | 
						|
 | 
						|
And the main source of inspiration for starting the project is the awesome [Zwibbler](https://zwibbler.com/demo/) app.
 | 
						|
 | 
						|
## Contributors
 | 
						|
 | 
						|
### Code Contributors
 | 
						|
 | 
						|
This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].
 | 
						|
<a href="https://github.com/excalidraw/excalidraw/graphs/contributors"><img src="https://opencollective.com/excalidraw/contributors.svg?width=890&button=false" /></a>
 | 
						|
 | 
						|
### Financial Contributors
 | 
						|
 | 
						|
Become a financial contributor and help us sustain our community. [[Contribute](https://opencollective.com/excalidraw/contribute)]
 | 
						|
 | 
						|
#### Individuals
 | 
						|
 | 
						|
<a href="https://opencollective.com/excalidraw"><img src="https://opencollective.com/excalidraw/individuals.svg?width=890"></a>
 | 
						|
 | 
						|
#### Organizations
 | 
						|
 | 
						|
Support this project with your organization. Your logo will show up here with a link to your website. [[Contribute](https://opencollective.com/excalidraw/contribute)]
 | 
						|
 | 
						|
<a href="https://opencollective.com/excalidraw/organization/0/website"><img src="https://opencollective.com/excalidraw/organization/0/avatar.svg"></a>
 | 
						|
<a href="https://opencollective.com/excalidraw/organization/1/website"><img src="https://opencollective.com/excalidraw/organization/1/avatar.svg"></a>
 | 
						|
<a href="https://opencollective.com/excalidraw/organization/2/website"><img src="https://opencollective.com/excalidraw/organization/2/avatar.svg"></a>
 | 
						|
<a href="https://opencollective.com/excalidraw/organization/3/website"><img src="https://opencollective.com/excalidraw/organization/3/avatar.svg"></a>
 | 
						|
<a href="https://opencollective.com/excalidraw/organization/4/website"><img src="https://opencollective.com/excalidraw/organization/4/avatar.svg"></a>
 | 
						|
<a href="https://opencollective.com/excalidraw/organization/5/website"><img src="https://opencollective.com/excalidraw/organization/5/avatar.svg"></a>
 | 
						|
<a href="https://opencollective.com/excalidraw/organization/6/website"><img src="https://opencollective.com/excalidraw/organization/6/avatar.svg"></a>
 | 
						|
<a href="https://opencollective.com/excalidraw/organization/7/website"><img src="https://opencollective.com/excalidraw/organization/7/avatar.svg"></a>
 | 
						|
<a href="https://opencollective.com/excalidraw/organization/8/website"><img src="https://opencollective.com/excalidraw/organization/8/avatar.svg"></a>
 | 
						|
<a href="https://opencollective.com/excalidraw/organization/9/website"><img src="https://opencollective.com/excalidraw/organization/9/avatar.svg"></a>
 |