"We learn big things from small experiences" - Bram Stoker
Dracula Theme is an open-source project driven by and for the community. Most apps that support the theme are contributions from our community.
As much as the team is responsible for the core theme and wants to support all available applications, we can only do so much ourselves.
That's why the community is essential for this project to keep evolving. Below are some tips for contributors.
⚡ This template repository is organized for easy use:
README.md: Introduction and guide for GitHub users.screenshot.pngorscreenshot/: Preview images displayed on draculatheme.com.INSTALL.md: Installation instructions to display on the website.sample: Code samples in various languages to aid theme creation. (Consider removing this folder before submission.)
Themes on draculatheme.com show a preview image on their page. You can provide one or more screenshots in two ways:
| Approach | When to use |
|---|---|
screenshot.png at the repo root |
A single preview is enough (default and simplest option). |
screenshot/ folder with multiple images |
You want to show different views, platforms, or variants (e.g. editor, terminal, light/dark). |
Priority: if the screenshot/ folder contains at least one supported image, the website uses those files and ignores the root screenshot.png. If the folder is missing or empty, the site falls back to screenshot.png.
Supported formats: .png, .jpg, .jpeg, .webp, .gif
Ordering: images in screenshot/ are sorted alphabetically by filename. Use numbered prefixes when order matters (e.g. 01-overview.png, 02-settings.png).
Gallery: when multiple images are present, the theme page renders an interactive gallery with thumbnails.
See screenshot/SCREENSHOT.md for detailed guidance.
Previously, default formatting settings were included. Now, we recommend preparing your theme with this command:
npx prettier . --writeWhat is that
npxthing?npxships withnpmand lets you run locally installed tools.
The creators behind the scenes are Lucas de França and Zeno Rocha.
Reach out via email or follow us on Twitter/X: Zeno Rocha and Luxonauta (Lucas).
Theme pages on draculatheme.com are generated at build time from the files in each theme repository (README.md, INSTALL.md, and screenshots). The website doesn't fetch this content live.
This means a merged pull request won't show up on the website right away; it appears after the next site rebuild. Rebuilds happen roughly once a week, usually in batches alongside other theme updates and maintenance fixes.
If your change needs to go live sooner, mention our team in the pull request and we may trigger a rebuild manually.