{"id":15137968,"url":"https://github.com/dimchikkk/velo","last_synced_at":"2025-04-05T16:11:14.658Z","repository":{"id":149896802,"uuid":"611979988","full_name":"Dimchikkk/velo","owner":"Dimchikkk","description":"App for brainstorming \u0026 sharing ideas 🦀 Learning Project","archived":false,"fork":false,"pushed_at":"2024-06-12T18:30:56.000Z","size":118966,"stargazers_count":329,"open_issues_count":16,"forks_count":24,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-29T15:11:20.923Z","etag":null,"topics":["bevy","bevy-ui","rust","webgpu"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dimchikkk.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":"contributing.md","funding":null,"license":"LICENSE-APACHE","code_of_conduct":"code_of_conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"security.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-10T00:03:29.000Z","updated_at":"2025-03-14T10:29:43.000Z","dependencies_parsed_at":"2024-06-13T01:14:17.604Z","dependency_job_id":"a05f75e3-5fdc-45be-a74a-2535632f1663","html_url":"https://github.com/Dimchikkk/velo","commit_stats":{"total_commits":723,"total_committers":12,"mean_commits":60.25,"dds":0.07883817427385897,"last_synced_commit":"8489b7e99471c798d06648edf47b54fd2502cd2e"},"previous_names":["staffengineer/rusticify","dimchikkk/velo"],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dimchikkk%2Fvelo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dimchikkk%2Fvelo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dimchikkk%2Fvelo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dimchikkk%2Fvelo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dimchikkk","download_url":"https://codeload.github.com/Dimchikkk/velo/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247361697,"owners_count":20926643,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bevy","bevy-ui","rust","webgpu"],"created_at":"2024-09-26T07:03:56.018Z","updated_at":"2025-04-05T16:11:14.624Z","avatar_url":"https://github.com/Dimchikkk.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Velo 🚵‍♀️🚵\n![Rust](https://img.shields.io/badge/Rust-lang-000000.svg?style=flat\u0026logo=rust)[![codecov](https://codecov.io/gh/StaffEngineer/velo/branch/main/graph/badge.svg?token=QGEKLM6ZDF)](https://codecov.io/gh/StaffEngineer/velo)\n\n![velo](./velo.gif)\n![alt text](velo.png \"Velo\")\n\n## Demo\n\nThis app is primarily designed for native desktop platforms, and its\nWebAssembly (wasm) target has a limited feature set. wasm target is best\nsuited for quick document sharing, currently, only WebGPU backend enabled for the demo:\n\n  [\u003chttps://dimchikkk.github.io/velo?document=https://gist.githubusercontent.com/StaffEngineer/bf7d94759abbd7aa722330e5fe4f0bd5/raw/e817be0ba700e94be472d435638d762b9deadf33/velo.json\u003e](https://staffengineer.github.io/velo?document=https://gist.githubusercontent.com/StaffEngineer/bf7d94759abbd7aa722330e5fe4f0bd5/raw/e817be0ba700e94be472d435638d762b9deadf33/velo.json)\n\n## What\\'s implemented:\n-   support rectangle/circle/paperlike notes\n-   add/remove note\n-   note resizing\n-   note repositioning\n-   wrapped text inside notes\n-   paste screenshot from clipboard [native target only 🖥️] \n-   connect notes with arrows\n-   make app snapshot in memory and load from it (MacOs: Command + s\\[l\\])\n-   save app state to database and load from it\n-   change background color of notes\n-   move note to front/back\n-   positioning text inside note\n-   multiple documents/tabs support\n-   load app state from url\n-   ability to create sharable url of the document using \\\"Share\n    Document\\\" button (**.velo.toml** should be created in user's home\n    directory containing GitHub access token with \\\"gist\\\" scope) [native target only 🖥️]:\n\n   ```toml\n   github_access_token = \"\u003cgithub_access_token\u003e\"\n   ```\n\n- initial markdown support\n  - italic/bold text style\n  - links\n  - syntax highlighting\n  - headings (proper headings support was temporarily removed)\n  - inline code\n  - ordered/unordered lists\n- particles effect [native target only 🖥️]\n- filter documents by text in notes (fuzzy search) [native target only 🖥️]\n- highlight notes containing searched text [native target only 🖥️]\n- ligature/emoji rendering support [emoji native target only 🖥️]\n- dark/light theme support (app restart is required for now)\n- infinite canvas with zooming (right click to move camera, mouse wheel to zoom)\n- undo/redo for text editing [native target only 🖥️]\n- drawing mode (click on pencil icon to enable it)\n- draw line, arrow, rhombus or rectangle by choosing 2 points\n- hide/show children notes for selected note\n- navigation to random note\n\n## Installation\n\n[Archives of precompiled binaries for *velo* are available for Windows, macOS\nand Linux.](https://github.com/StaffEngineer/velo/releases/latest)\n\n### Compiling from Source\n\nIf you want to compile from source you can use \n```sh\ncargo install --path .\n```\n\n**ATTENTION**\nIf you have set your cargo target directory in `.cargo/config.toml` you must provide the fullpath to the assets directory like this\n```sh\nBEVY_ASSET_PATH=$(realpath assets) cargo install --path .\n```\n\n## Run\n\nNative:\n\n```sh\ncargo r --release\n```\n\nWasm:\n\n```sh\ncargo install wasm-server-runner\nRUSTFLAGS=--cfg=web_sys_unstable_apis cargo r --release --target wasm32-unknown-unknown\n```\n\nTo create app bundle with icon (tested only on MacOS):\n\n```sh\ncargo install cargo-bundle\ncargo bundle\n```\n\n## Pre-commit actions\n\n```sh\ncargo fmt\ncargo clippy -- -A clippy::type_complexity -A clippy::too_many_arguments\n```\n\n## Basic usage\n\n- click on rectangle icon to create rectangle note\n- double-click to select note\n- start typing to add text to selected note\n- resize note by dragging its corners\n- click on canvas to deselect note\n- move note by dragging it (only unselected note can be dragged to allow mouse text selection for selected note)\n- click on little arrow connector icon to connect notes, arrow connector icons are placed on each side of note\n- for native target there is search box that allows to filter documents by text in notes (fuzzy search)\n- for wasm target there is url query parameter `?document=\u003curl\u003e` to load document from url\n- click save icon to save document to database on native platform or to localStorage on wasm target\n- click on drawing pencil to enable drawing mode\n\n## Troubleshooting\n\nIf the application fails to start, you can try resolving the issue by removing velo data folder. This problem may occur due to changes in the data schema between different versions of the application.\n\n- MacOS: `/Users/\u003cusername\u003e/Library/Application Support/velo`\n- Windows: `C:\\Users\\\u003cusername\u003e\\AppData\\Roaming\\velo`\n- Linux: `/home/\u003cusername\u003e/.config/velo`\n- wasm: `localStorage.clear()`\n\n## License\nAll code in this repository dual-licensed under either:\n\nMIT License or http://opensource.org/licenses/MIT\nApache License, Version 2.0 or http://www.apache.org/licenses/LICENSE-2.0\nUnless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.\n\n## Contributing\nContributions are always welcome! Please adhere to this project\\'s code\nof conduct.\n\n❤️\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdimchikkk%2Fvelo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdimchikkk%2Fvelo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdimchikkk%2Fvelo/lists"}