{"id":17832436,"url":"https://github.com/cecilapp/links","last_synced_at":"2025-03-19T11:30:25.525Z","repository":{"id":73161084,"uuid":"487657344","full_name":"Cecilapp/Links","owner":"Cecilapp","description":"Links is a Linktree alternative powered by Cecil, Tailwind CSS and Font Awesome.","archived":false,"fork":false,"pushed_at":"2024-02-26T22:52:18.000Z","size":3597,"stargazers_count":3,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-13T21:55:13.247Z","etag":null,"topics":["cecil","cecil-starter","static-site","tailwindcss"],"latest_commit_sha":null,"homepage":"https://links.cecil.app","language":"CSS","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/Cecilapp.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},"funding":{"github":"ArnaudLigny","open_collective":"cecil"}},"created_at":"2022-05-01T22:36:29.000Z","updated_at":"2024-02-08T20:37:58.000Z","dependencies_parsed_at":"2023-06-17T21:02:25.724Z","dependency_job_id":"3928f80c-815c-44b0-b1d9-098ac1836822","html_url":"https://github.com/Cecilapp/Links","commit_stats":{"total_commits":101,"total_committers":3,"mean_commits":"33.666666666666664","dds":"0.29702970297029707","last_synced_commit":"6d3ce9772124ca0af8a99b5116d2f224af873869"},"previous_names":[],"tags_count":2,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cecilapp%2FLinks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cecilapp%2FLinks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cecilapp%2FLinks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cecilapp%2FLinks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cecilapp","download_url":"https://codeload.github.com/Cecilapp/Links/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244416810,"owners_count":20449342,"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":["cecil","cecil-starter","static-site","tailwindcss"],"created_at":"2024-10-27T19:57:39.956Z","updated_at":"2025-03-19T11:30:25.506Z","avatar_url":"https://github.com/Cecilapp.png","language":"CSS","funding_links":["https://github.com/sponsors/ArnaudLigny","https://opencollective.com/cecil"],"categories":[],"sub_categories":[],"readme":"_Links_ is a Linktree alternative powered by [Cecil](https://cecil.app), [Tailwind CSS](https://tailwindcss.com) and [Font Awesome](https://fontawesome.com).\n\n[![Links website](docs/screenshot.png)](https://links.cecil.app)\n\nDemo: \u003chttps://cecil-links-demo.netlify.app\u003e\n\n## Install\n\n\u003e [!IMPORTANT]\n\u003e PHP 8.1 and [Composer](https://getcomposer.org) are required.\n\nThe easiest way to create a new Links project is using Composer:\n\n```bash\ncomposer create-project cecil/links --ask\n```\n\n## Usage\n\n### Preview\n\nYou can easily preview your site locally with the following command:\n\n```bash\nphp cecil.phar serve --open\n```\n\n\u003e [!TIP]\n\u003e The option `--open` automatically open your site in the default web browser.\n\n### Configuration\n\nDefine site configuration and social identities in [`cecil.yml`](cecil.yml):\n\n```yaml\ntitle: \u003cmain title\u003e\nbaseurl: \u003csite URL, with a final backslash\u003e\nbaseline: \"\u003cshort presentation\u003e\" # optional, recommended\ndescription: \"\u003cSEO description\u003e\" # optional, recommended\nauthor: # used by metatags, optional\n  name: \u003cauthor name\u003e\n  url: \u003curl\u003e\n  email: \u003cemail\u003e # used in social identities block, optional\nsocial: # social identities\n  \u003cname\u003e: # github, linkedin, instagram, youtube, mastodon, bluesky, threads, twitter or x\n    url: \u003curl\u003e\navatar: avatar.png\nimage: avatar.png # Open Graph image, optional, recommended\nmanifest:\n  theme_color: \"#0369a1\"   # theme color\n  background_color: \"#fff\" # PWA background color\nserviceworker:\n  enabled: false           # turns on PWA\n# CSS theme and buttons colors\nlinks:\n  theme: default # \"default, \"gradient-1\" or \"gradient-2\"\n  buttons:\n    color: page # page or css ('page' by default)\n```\n\n\u003e [!TIP]\n\u003e The exhaustive [Cecil](https://cecil/app) documentation is available at [cecil.app](https://cecil.app/documentation/configuration/).\n\n### Manage page\n\nFrom `pages/index.md` file you can:\n\n1. change page structure with _blocks_ array in _front matter_\n2. add links in _front matter_\n3. add rich content authoring in Markdown in page _body_ (optional)\n\n```yaml\n---\nblocks:\n  - name: content # page content\n  - name: links   # page links\n  - name: social  # social identities\nlinks:\n  - title: \u003ctitle\u003e\n    url: \u003curl\u003e\n    color: \"\u003c#hexa_code\u003e\" # hexadecimal color code, optional (e.g. \"#1DA1F2\")\n    icon: \u003cstyle\u003e:\u003cname\u003e # Font Awesome icon (https://fontawesome.com/icons), optional (e.g. \"brands:github\")\n---\nContent here.\n```\n\n## Publish\n\nRun the following command:\n\n```bash\nphp cecil.phar build\n```\n\nThen just deploy the content of __site_ directory to your web hosting solution.\n\n## Customize\n\nYou can disable buttons custom color:\n\n_cecil.yml:_\n\n```yaml\nlinks:\n  buttons:\n    color: css\n```\n\n### Theme\n\n[Tailwind CSS](https://tailwindcss.com) is required:\n\n```bash\nnpm install -D tailwindcss\n```\n\n#### Theme colors\n\nYou can change [theme colors](ttps://tailwindcss.com/docs/customizing-colors) through the file `tailwind.config.js`, then rebuild CSS:\n\n```bash\nnpx tailwindcss -i ./themes/links/tailwind.css -o ./assets/styles.css\n```\n\n#### Theme CSS\n\nYou can change theme CSS through the file `tailwind.css`:\n\n1. Copy `./theme/links/tailwind.css` to `./tailwind.css`\n2. Rebuild CSS:\n\n```bash\nnpx tailwindcss -i ./tailwind.css -o ./assets/styles.css\n```\n\n## Update\n\nIf you want to update the [_links_](https://github.com/Cecilapp/theme-links#readme) theme and _component themes_ (i.e.: [_fontawesome_](https://github.com/Cecilapp/theme-fontawesome#readme), [_pwa_](https://github.com/Cecilapp/theme-pwa#readme) and [_netlity_](https://github.com/Cecilapp/theme-netlify#readme)) you must run the following command:\n\n```bash\ncomposer update\n```\n\n## License\n\n_Links_ is a free software distributed under the terms of the MIT license.\n\n© [Arnaud Ligny](https://arnaudligny.fr)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcecilapp%2Flinks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcecilapp%2Flinks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcecilapp%2Flinks/lists"}