Skip to content

notkainoa/draw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Draw Logo

Note

This is a fork of macintushar/draw

Draw is a wrapper around Excalidraw, integrated with Supabase to save and sync your drawings seamlessly across different devices. It allows you to use Excalidraw anywhere while keeping your data available everywhere.

Features diff from fork

* Excalidraw: Leverages the functionality of Excalidraw, a popular web-based drawing tool.
* Cloud Sync: Uses Supabase for authentication and storage, ensuring secure access and synchronization of your drawings.
+ Folders: Organize drawings into folders.
+ Sidebar: Navigate and manage folders and drawings from a sleek sidebar.
- Clunky UI: Removed clunky, unnecessary ui components from the UI.

Getting Started

Usage

  • Sign Up or Log In: Use the authentication flow provided by Supabase to sign up or log in.
  • Create and Edit Drawings: Use the Excalidraw interface to create or edit drawings.
  • Save Drawings: Drawings are automatically saved to your Supabase database.
  • Access Anywhere: Log in from any device to access and sync your drawings.

Deployment

To deploy the app, you can use platforms like Vercel or Netlify. We have set up a one-click deploy to Vercel.

Deploy with Vercel

If you want to deploy using Docker, you can use the provided docker-compose file, using the instruction in the Docker section.

If you'd like to build the app yourself, run:

bun run build

Deploy to other hosting providers by following their specific deployment instructions.

Tech Stack / Libraries

  • Vite (React)
  • Tailwind CSS with shadcn/ui
  • Tanstack Query and Router
  • Excalidraw
  • Supabase
  • Sentry
  • Day.js
  • cmdk
  • Zod
  • Bun

and many others.

Contributing

Contributions are welcome! For major changes, please open an issue to discuss what you would like to change. Otherwise:

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Open a pull request

Development

Prerequisites

DB Structure and Setup

This is a visual of the Database Schema on Supabase. Read docs/supabase.md for more detailed information on how to set up Supabase to work with Draw. DB Schema

Installation

Clone the repository:

git clone https://github.com/macintushar/draw.git
cd draw

Install dependencies:

bun install

Set up your environment variables:

Create a .env file in the root directory and add your Supabase and Sentry credentials:

cp .env.example .env

Run the development server:

bun run dev

Your app will be available at http://localhost:5173.

Acknowledgments

  • Excalidraw for providing the best open-source drawing tool. This wouldn't be possible without them (literally).
  • macintushar/draw for the original project this was forked from.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Contact

If you have any questions or suggestions, feel free to email me at (k@kainoa.me)[mailto:k@kainoa.me]

About

Free Self Hostable Excalidraw Plus

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Contributors 5