{"id":14979264,"url":"https://github.com/piazzai/cvless","last_synced_at":"2026-04-25T23:00:47.130Z","repository":{"id":59492036,"uuid":"303761430","full_name":"piazzai/cvless","owner":"piazzai","description":"Jekyll theme for a beautiful online CV","archived":false,"fork":false,"pushed_at":"2026-04-25T21:01:21.000Z","size":4495,"stargazers_count":143,"open_issues_count":0,"forks_count":145,"subscribers_count":3,"default_branch":"master","last_synced_at":"2026-04-25T21:13:46.172Z","etag":null,"topics":["bootstrap","css","cv","cv-template","hack","html","iconoir","javascript","jekyll","jekyll-blog","jekyll-site","jekyll-template","jekyll-theme","jekyll-website","online-cv","open-color","particles-js","piazzolla","poole","sass"],"latest_commit_sha":null,"homepage":"https://piazzai.github.io/cvless/","language":"SCSS","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/piazzai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2020-10-13T16:19:41.000Z","updated_at":"2026-04-25T21:00:24.000Z","dependencies_parsed_at":"2024-09-11T14:25:06.144Z","dependency_job_id":"612519ca-e7d3-48a0-bef4-425d9e2321ae","html_url":"https://github.com/piazzai/cvless","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/piazzai/cvless","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piazzai%2Fcvless","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piazzai%2Fcvless/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piazzai%2Fcvless/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piazzai%2Fcvless/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/piazzai","download_url":"https://codeload.github.com/piazzai/cvless/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piazzai%2Fcvless/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32279660,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T18:29:39.964Z","status":"ssl_error","status_checked_at":"2026-04-25T18:29:32.149Z","response_time":59,"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":["bootstrap","css","cv","cv-template","hack","html","iconoir","javascript","jekyll","jekyll-blog","jekyll-site","jekyll-template","jekyll-theme","jekyll-website","online-cv","open-color","particles-js","piazzolla","poole","sass"],"created_at":"2024-09-24T13:59:43.379Z","updated_at":"2026-04-25T23:00:47.116Z","avatar_url":"https://github.com/piazzai.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cvless\n\nCvless is a theme for static websites built with Jekyll. It aims for simplicity and readability by following best practices of graphic design, like the use of [high contrast](https://www.contrastrebellion.com), [law of proximity](https://lawsofux.com/law-of-proximity), and responsive layout. Its typography is based on the [Piazzolla system](https://piazzolla.huertatipografica.com/), which performs extremely well over a wide range of font sizes.\n\nThe main aesthetic feature of the theme is the use of [particles.js](https://vincentgarreau.com/particles.js/) in the home and the 404 pages. In addition, the theme includes a well-designed CV page. Printing this from browser automatically adapts the layout for a more traditional appearance, so you no longer have to maintain a separate CV for offline distribution. Finally, the theme offers a simple and easily extensible blog.\n\nLight and dark modes are available. The theme initializes based on system preferences and stores the user's preference for the duration of the session.\n\nSee the [demo](https://piazzai.github.io/cvless) to get a better sense of what the theme looks like.\n\n## Installation\n\nThe theme can be installed as usual by cloning this repository and editing the files. However, it is far more convenient to install it as a gem, in which case all the files you do not want or need to customize remain hidden from view, but will still be read and processed during build.\n\nIf you choose to install the theme as a gem, your site should include at a minimum the following files:\n\n```bash\n.\n├── 404.md\n├── _config.yml\n├── Gemfile\n├── cv.md\n└── index.md\n```\n\nTo install the theme, you can then add this line to your `Gemfile`:\n\n```ruby\ngem \"cvless\"\n```\n\nAnd this line to `_config.yml`:\n\n```yaml\ntheme: cvless\n```\n\nThe easiest way to set up a new website in this way is to clone the contents of the `demo` folder. This provides a working set of files to get you started. You can remove what you will not use, such as the contents of the `_posts` folder.\n\nAfter you are done creating the basic files, run bundler:\n\n    $ bundle\n\nOr install the gem yourself as:\n\n    $ gem install cvless\n\nTo customize hidden files, you can create new files with the same names and paths. For example, to change the layout of the index page, you can create a `_layouts` folder and a file `index.html` within this folder that contains your custom code. During build, Jekyll will give priority to your files over the theme's.\n\n## Usage\n\nBasic configuration occurs in `_config.yml`. This contains site variables such as title, tagline, url, and repository address, as well as the author's name and email address for inclusion in blog posts. You can specify the path to an avatar for inclusion in the home (optional).\n\nMore advanced configuration requires altering some files that are not included in the `demo` template and are hidden in the original theme. There are three files you might want to customize. First, you could change icon links in `_includes/particles-home.html` and add/remove icons as needed. You may add icons that are not included in the theme by default. For more information on how to do this, see [this post](https://piazzai.github.io/cvless/2022/08/01/on-the-use-of-icons/).\n\nSecond, you might want to edit the style variables specified in `_sass/_variables.scss`. These allow you to customize the theme's color scheme and typefaces. There are many resources on the web to learn the principles of good web design. I personally recommend Matthew Butterick's [Practical Typography](https://practicaltypography.com/websites.html).\n\nIn addition to these files, you can customize favicons in the `assets` folder. For that, [favicon.io](https://favicon.io/) is an excellent tool. You can also change the particles.js configurations in `assets/js/particles.json`. The [library homepage](https://vincentgarreau.com/particles.js/) features an interactive tool from which you can export a new configuration.\n\n## Credits\n\nThe theme draws in one way or another from the following projects:\n\n-   [Bootstrap](https://getbootstrap.com/)\n-   [Hack](https://sourcefoundry.org/hack/)\n-   [Iconoir](https://iconoir.com/)\n-   [Open Color](https://yeun.github.io/open-color/)\n-   [Particles.js](https://vincentgarreau.com/particles.js/)\n-   [Piazzolla](https://piazzolla.huertatipografica.com/)\n-   [Poole](https://getpoole.com/)\n\n## Bugs\n\nIf you find any problem using this theme, please [open an issue](https://github.com/piazzai/cvless/issues).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiazzai%2Fcvless","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiazzai%2Fcvless","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiazzai%2Fcvless/lists"}