{"id":17726565,"url":"https://github.com/masterkram/minted-directory-astro","last_synced_at":"2026-01-19T22:12:27.998Z","repository":{"id":258248906,"uuid":"873250386","full_name":"masterkram/minted-directory-astro","owner":"masterkram","description":"Markdown driven directory template. Built with Astro and Tailwindcss. Optimized for SEO. Beautiful Customizable Style","archived":false,"fork":false,"pushed_at":"2025-04-02T13:15:16.000Z","size":16900,"stargazers_count":95,"open_issues_count":5,"forks_count":15,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-07T22:42:36.487Z","etag":null,"topics":["astro","directory"],"latest_commit_sha":null,"homepage":"https://minteddirectory.com","language":"Astro","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/masterkram.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-10-15T21:09:01.000Z","updated_at":"2025-05-07T06:26:15.000Z","dependencies_parsed_at":"2024-10-25T21:18:22.732Z","dependency_job_id":null,"html_url":"https://github.com/masterkram/minted-directory-astro","commit_stats":null,"previous_names":["masterkram/minted-directory-astro"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/masterkram/minted-directory-astro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/masterkram%2Fminted-directory-astro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/masterkram%2Fminted-directory-astro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/masterkram%2Fminted-directory-astro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/masterkram%2Fminted-directory-astro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/masterkram","download_url":"https://codeload.github.com/masterkram/minted-directory-astro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/masterkram%2Fminted-directory-astro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28580360,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T18:29:59.827Z","status":"ssl_error","status_checked_at":"2026-01-19T18:29:40.878Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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","directory"],"created_at":"2024-10-25T17:05:56.756Z","updated_at":"2026-01-19T22:12:27.983Z","avatar_url":"https://github.com/masterkram.png","language":"Astro","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eMinted Directory Astro\u003c/h1\u003e\n  \u003cp\u003eMarkdown driven directory template. Built with Astro and Tailwindcss. Optimized for SEO. Beautiful Customizable Style\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/febde860-00be-408b-8a13-41953f7178e1\" alt=\"Minted Directory Screenshot\" /\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n## Features:\n+ 🖌️ Add listings from is possible from different formats: `markdown`, `csv`, `json`, `google sheets`, `notion`, `airtable`.\n+ 🔋 SEO optimized and programmatic SEO out of the box\n+ 💻 Pre-built components for directories.\n+ 💅 Customizable styles.\n+ 🌙 Dark/Light mode\n+ 💸 Sponsored Content\n+ 👀 Tags + Search\n\n## Getting Started\n\n### Local Development\n\nDuplicate the template then clone the repository.\n\n```sh\ngit clone git@github.com:youraccount/projectname.git my-directory\n```\n\nOr use the github cli to create a repository based on the template and clone in one command:\n\n```sh\ngh repo create my-directory --template masterkram/minted-directory-astro --private --clone\n```\n\nGo to the cloned folder:\n```sh\ncd my-directory\n```\n\nInstall dependencies\n\n```sh\npnpm install\n```\n\nRun the website:\n\n```sh\npnpm dev\n```\n\nCongrats :tada:\n\nYou can start customizing and building your directory.\n\n## Adding Content\n\nAdding content to the directory can be done using one of the following formats:\n+ markdown\n+ json\n+ csv\n+ notion\n+ google sheets\n+ airtable\n\nRemember that listings will not be shown on the live website until the site is re-built and deployed. This is done to ensure the fastest possible performance by serving static html, css and js.\n\n### Using markdown listings:\n1. add markdown files to the `src/data/directory` folder. All markdown files will be automatically loaded as listings.\n2. You must specify required properties of a listing such as title and description in the [frontmatter]() of the file\n\n### Using json listings:\n1. add a single json file: `src/data/directory/directory.json`\n2. in this json file, the root element is an array. This array can contain objects which are the listings of the directory. These require the properties of `id`, `name` and `description`.\n\n### Using csv listings:\n1. add a single csv file: `src/data/directory/directory.csv`\n2. add rows to this csv file, these require the properties of `id`, `name` and `description`.\n\n### Using google sheets listings:\n1. Create a [google sheets](https://docs.google.com/spreadsheets/u/0/) document.\n2. You need to select your table and click `Format \u003e Convert to table`\n3. Make it publicly shareable. When you share the link. copy the id\n4. Go to `settings.toml`, here you need to set the `source=sheets` and `key = ` the copied id of the file\n\nUse this spreadsheet as a starting point: [directory google sheet data](https://docs.google.com/spreadsheets/d/1BKVVFysQT8ZuPY8hUp--jwTrN-U20TrtML0idECIWmc/edit?usp=sharing)\n\n### Using notion listings:\n\n### Using airtable listings:\n\n\n## Customization\n\nTo customize the directory style:\n+ Change the `--color-primary-x00` variables, `--color-gray-x00` variables in the `src/styles/global.css`\n+ Change the font:\n  + install from [fontsource]()\n  + import font in `BaseLayout.astro`\n  + change the `--font-sans` variable in `global.css`\n+ Customize the `src/data/config/settings.toml` to your preferences.\n\n### Pre-made styles:\n- spearmint\n- peppermint\n\n### Adding Content\n\nAdd listings by adding markdown files to `/src/content/directory`\n\n## Deployment\n\nDeploy as a static site for best SEO performance:\n\n```bash\npnpm run build\n```\n\n## Community\n\n[Join the discord](https://discord.gg/5UbrTNzX7y)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmasterkram%2Fminted-directory-astro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmasterkram%2Fminted-directory-astro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmasterkram%2Fminted-directory-astro/lists"}