{"id":45779104,"url":"https://github.com/jhadida/deelan","last_synced_at":"2026-04-01T18:12:44.650Z","repository":{"id":339906192,"uuid":"1160416023","full_name":"jhadida/deelan","owner":"jhadida","description":"Convert your daily notes to a blog and manage your snippets.","archived":false,"fork":false,"pushed_at":"2026-03-18T07:38:12.000Z","size":19814,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-18T22:44:21.980Z","etag":null,"topics":["astro","cli","knowledge-ba","markdown","mathjax-support","notes","notes-app","shiki","static-site","static-site-gen"],"latest_commit_sha":null,"homepage":"https://jhadida.github.io/deelan/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jhadida.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-17T23:02:01.000Z","updated_at":"2026-03-18T07:38:15.000Z","dependencies_parsed_at":"2026-03-06T10:01:28.428Z","dependency_job_id":null,"html_url":"https://github.com/jhadida/deelan","commit_stats":null,"previous_names":["jhadida/deelan"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/jhadida/deelan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhadida%2Fdeelan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhadida%2Fdeelan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhadida%2Fdeelan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhadida%2Fdeelan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jhadida","download_url":"https://codeload.github.com/jhadida/deelan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhadida%2Fdeelan/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290785,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["astro","cli","knowledge-ba","markdown","mathjax-support","notes","notes-app","shiki","static-site","static-site-gen"],"created_at":"2026-02-26T10:55:27.915Z","updated_at":"2026-04-01T18:12:44.617Z","avatar_url":"https://github.com/jhadida.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Deelan\n\nData Engineering Electronic LAboratory Notebook.  \n**Elevate your note-keeping experience.**\n\n[![npm version](https://img.shields.io/npm/v/%40jhadida%2Fdeelan)](https://www.npmjs.com/package/@jhadida/deelan)\n[![docs](https://img.shields.io/badge/docs-online-2ea44f)](https://jhadida.github.io/deelan)\n[![gallery](https://img.shields.io/badge/gallery-screenshots-0ea5e9)](https://jhadida.github.io/deelan/main-gallery/)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"logos/deelan-cartoon.png\" alt=\"Deelan logo\" width=\"280\" /\u003e\n\u003c/p\u003e\n\nDeelan is designed for people who want a durable, searchable, versioned knowledge base that stays close to plain text authoring and yet provides a useful, scaleable, and beautiful web-based view to navigate contents. \n\nYou keep Markdown-formatted notes with rich authoring features in a simple git repo.  \nDeelan creates a beautiful, scalable, private, and feature-rich navigation experience with just a handful of configuration files and CLI commands. \n\n## What Deelan Gives You\n\n- Post + snippet content model with frontmatter validation. Templates provided for VSCode and Obsidian.\n- Quickly find contents with an advanced search grammar, hierarchical tags, date ranges, and more.\n- Rich rendered views out-of-the-box with code highlighting, Mathjax, git timelines, internal links, and more. \n- Static, local-first workflow (offline-friendly), with guidance and templates for secure private deployment.\n- Export to self-contained HTML and PDF, share permalinks, explore and extend analytics.\n\n\u003e [!NOTE]\n\u003e Deelan is currently published as an early `0.x` experimental workflow.\n\u003e Expect iterative changes to CLI surface, generated outputs, and docs while the release hardening pass continues.\n\n## Install\n\nFrom npm (once published):\n\n```bash\nnpm install -g @jhadida/deelan\ndeelan --help\n```\n\nWithout global install:\n\n```bash\nnpx @jhadida/deelan --help\n```\n\nRepository-local usage for contributors:\n\n```bash\nnode ./bin/deelan.mjs --help\n```\n\n## Quickstart\n\n```bash\ndeelan init my-notebook\ncd my-notebook\ndeelan validate\ndeelan build\ndeelan serve\n```\n\nOpen `http://localhost:4321`.\n\n## Core Commands\n\n```bash\ndeelan --help\ndeelan version\ndeelan init --help\ndeelan validate --help\ndeelan build --help\ndeelan serve --help\ndeelan tags --help\ndeelan export --help\n```\n\nOptional PDF export dependencies:\n\n```bash\nnpm install playwright\nnpx playwright install chromium\n```\n\n## High Level Guidance\n\nMarkdown files are stored in a `content/` folder for both posts and snippets.\nContent IDs are filename-derived and type-prefixed:\n\n- `content/posts/partitioning-primer.md` -\u003e `post--partitioning-primer`\n- `content/snippets/pandas-groupby.md` -\u003e `snippet--pandas-groupby`\n\nThese IDs are used by search, related links, routes, and export commands.\nTags can be assigned to posts and snippets alike, and are hierarchical in nature with dot-separators e.g. `python.pandas.groupby`.\nContent assets (like figures) are typically stored under an asset folder `content/\u003ctype\u003e/assets/`.\nWe strongly recommend versioning text contents with Git and non-text assets with LFS.\n\nProject settings live in `deelan.config.yml`.\nCommon options include default theme, timezone for rendered timestamps, and code highlighting themes.\nLearn more about typical workflows, and many more topics, in the [documentation](https://jhadida.github.io/deelan).\n\n## About this app \n\nCreated by [Jonathan Hadida](https://github.com/jhadida) proudly with the help of GPT-5.3-Codex and Sonnet 4.6 with minimal permissive dependencies (MIT/Apache-2.0 only for top-level dependencies).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjhadida%2Fdeelan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjhadida%2Fdeelan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjhadida%2Fdeelan/lists"}