Giter Club home page Giter Club logo

excalidraw's Introduction

Excalidraw logo: Sketch handrawn like diagrams.

Virtual whiteboard for sketching hand-drawn like diagrams.

Follow Excalidraw on Twitter

Try it now

Go to excalidraw.com to start sketching.

Read our blog and follow the guides to learn more about Excalidraw and how to use it effectively.

Shape libraries

Find a growing list of libraries containing assets for your drawings at libraries.excalidraw.com.

Run the code

Code Sandbox

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

git clone https://github.com/excalidraw/excalidraw.git

Commands

Command Description
npm install Install the dependencies
npm start Run the project
npm run fix Reformat all files with Prettier
npm test Run tests
npm run test:update Update test snapshots
npm run test:code Test for formatting with Prettier

Docker Compose

You can use docker-compose to work on excalidraw locally if you don't want to setup a Node.js env.

docker-compose up --build -d

Self hosting

We publish a Docker image with the Excalidraw client at excalidraw/excalidraw. You can use it to self host your own client under your own domain, on Kubernetes, AWS ECS, etc.

docker build -t excalidraw/excalidraw .
docker run --rm -dit --name excalidraw -p 5000:80 excalidraw/excalidraw:latest

The Docker image is free of analytics and other tracking libraries.

At the moment, self-hosting your own instance doesn't support sharing or collaboration features.

We are working towards providing a full-fledged solution for self hosting your own Excalidraw.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Translating

To translate Excalidraw into other languages, please visit our Crowdin page. To add a new language, open an issue so we can get things set up on our end first.

Translations will be available on the app if they exceed a certain threshold of completion (currently 85%).

Excalidraw is built using these awesome tools

And the main source of inspiration for starting the project is the awesome Zwibbler app.

Testimonials

Contributors

Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]

Individuals

Organizations

Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]

excalidraw's People

Contributors

lipis avatar dependabot-preview[bot] avatar dwelle avatar vjeux avatar giovannigiordano avatar fausto95 avatar ad1992 avatar tomayac avatar nanot1m avatar dai-shi avatar petehunt avatar gasimgasimzada avatar j-f1 avatar kbariotis avatar dependabot[bot] avatar voluntadpear avatar xixixao avatar yongdamsh avatar kentbeck avatar lusingander avatar bradymadden97 avatar lissitz avatar muzakparov avatar paulomenezes avatar jnforja avatar pshihn avatar idlewinn avatar renecode avatar steveruizok avatar warrenseine avatar

Stargazers

Roman avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.