{"id":15748899,"url":"https://github.com/grantbirki/astrowind-hard-fork","last_synced_at":"2025-03-29T23:33:55.807Z","repository":{"id":142176869,"uuid":"612982829","full_name":"GrantBirki/astrowind-hard-fork","owner":"GrantBirki","description":"Template repo for AstroWind on GitHub pages - Heavily favoring js config files","archived":false,"fork":false,"pushed_at":"2024-09-18T01:29:41.000Z","size":13746,"stargazers_count":3,"open_issues_count":29,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-26T10:46:33.706Z","etag":null,"topics":["astro","github-pages","static-site","website"],"latest_commit_sha":null,"homepage":"https://astro-demo.birki.io/","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/GrantBirki.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2023-03-12T15:04:22.000Z","updated_at":"2024-05-23T03:37:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"f650f0f9-485e-4f2e-8286-883c9c9a09c1","html_url":"https://github.com/GrantBirki/astrowind-hard-fork","commit_stats":null,"previous_names":["grantbirki/astrowind-hard-fork"],"tags_count":0,"template":true,"template_full_name":"onwidget/astrowind","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GrantBirki%2Fastrowind-hard-fork","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GrantBirki%2Fastrowind-hard-fork/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GrantBirki%2Fastrowind-hard-fork/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GrantBirki%2Fastrowind-hard-fork/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GrantBirki","download_url":"https://codeload.github.com/GrantBirki/astrowind-hard-fork/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222515734,"owners_count":16996249,"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":["astro","github-pages","static-site","website"],"created_at":"2024-10-04T06:01:08.908Z","updated_at":"2024-11-01T03:05:52.294Z","avatar_url":"https://github.com/GrantBirki.png","language":"Astro","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 AstroWind\n\n[![deploy](https://github.com/GrantBirki/astrowind/actions/workflows/deploy.yml/badge.svg)](https://github.com/GrantBirki/astrowind/actions/workflows/deploy.yml) [![ci](https://github.com/GrantBirki/astrowind/actions/workflows/ci.yml/badge.svg)](https://github.com/GrantBirki/astrowind/actions/workflows/ci.yml) [![lint](https://github.com/GrantBirki/astrowind/actions/workflows/lint.yml/badge.svg)](https://github.com/GrantBirki/astrowind/actions/workflows/lint.yml) [![CodeQL](https://github.com/GrantBirki/astrowind/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/GrantBirki/astrowind/actions/workflows/codeql-analysis.yml)\n\nThis is a custom AstroWind template for deployment to GitHub pages\n\n![example](docs/assets/example.png)\n\nThe original AstroWind template can be found here: [source](https://github.com/onwidget/astrowind)\n\n⚠️ Due to how fast the upstream source project has been moving and with how fast the Astro project has been moving, I am abandoning this fork. ⚠️\n\n## Features\n\n\u003e How is this template fork different?\n\nThis fork is designed for those who are not extremely familiar with Astro, or even web development in general. It is designed to be a simple, easy to use template for those who want to get started with Astro, but don't want to spend hours configuring the template.\n\nThis fork is also designed to be deployed to GitHub pages, which is a free and easy way to host your website.\n\n## Full Offline Development Support\n\nAfter running `npm i` and `npm run dev` for the first time, you can develop your site completely offline!\n\n## Config Files\n\nThe core way this template is different from the original is that it heavily uses `.js` config files to configure data and content for its site.\n\nHere are a few common config directories and what you will find there:\n\n- [`src/config/site/*`](src/config/site) - Site configuration\n  - [`config.js`](src/config/site/config.js) - Global site configuration\n  - [`blog.js`](src/config/site/blog.js) - Blog configuration\n- [`src/config/home/*`](src/config/home) - Home page configuration\n  - [`featured-posts.js`](src/config/home/featured-posts.js) - Featured blog posts on the home page\n  - [`hero.js`](src/config/home/hero.js) - Hero component configuration on the home page\n  - [`content.js`](src/config/home/content.js) - Main content component configuration on the home page\n- [`src/config/components/*`](src/config/components) - Component configuration\n  - [`announcement.js`](src/config/components/announcement.js) - Announcement component configuration on all pages\n  - [`footer.js`](src/config/components/footer.js) - Footer component configuration on all pages\n  - [`header.js`](src/config/components/header.js) - Header component configuration on all pages\n  - [`logo.js`](src/config/components/logo.js) - Logo (text) component configuration on all pages\n\n## Pages\n\nAstro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.\n\nThere's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.\n\nAny static assets, like images, can be placed in the `public/` directory if they do not require any transformation or in the `assets/` directory if they are imported directly.\n\n## Commands\n\nAll commands are run from the root of the project, from a terminal:\n\n| Command               | Action                                             |\n| :-------------------- | :------------------------------------------------- |\n| `npm install`         | Installs dependencies                              |\n| `npm run dev`         | Starts local dev server at `localhost:3000`        |\n| `npm run build`       | Build your production site to `./dist/`            |\n| `npm run preview`     | Preview your build locally, before deploying       |\n| `npm run format`      | Format codes with Prettier                         |\n| `npm run lint:eslint` | Run Eslint                                         |\n| `npm run astro ...`   | Run CLI commands like `astro add`, `astro preview` |\n\n## Development\n\nHere are some basic commands to get you up and running to develop with this template:\n\n1. Install `npm` dependencies\n\n   ```bash\n   npm i\n   ```\n\n2. Start the development server\n\n   ```bash\n   npm run dev\n   ```\n\n3. View your site at [`localhost:3000`](http://localhost:3000/)\n\n\u003e Live reload is enabled by default, so any changes you make will be reflected in the browser.\n\n## Deployment\n\n\u003e Deployment docs for GitHub Pages\n\nFirst, clone this repository to your own GitHub account\n\nIf you want to deploy to a basic GitHub domain name, do the following to [`src/config/site/config.js`](src/config/site/config.js):\n\n```js\norigin: 'https://grantbirki.github.io', // Change this to your GitHub username\nbasePathname: '/astrowind', // Change this to your repository name\n```\n\nIf you want to use your own custom domain name, do the following to [`src/config/site/config.js`](src/config/site/config.js):\n\n```js\norigin: 'https://astro-demo.birki.io', // Change this to your custom domain name make sure it points to your GitHub Pages domain\nbasePathname: '/', // leave this as a single /\n```\n\nEnsure you have configured GitHub Pages to use the GitHub Actions deployment option. When you `push` changes to your repository, GitHub will automatically build and deploy your site.\n\n### Branch Deploy\n\nThis template also comes bundled with the [branch-deploy](https://github.com/github/branch-deploy) Action. Please ensure you view the [`branch-deploy.yml`](.github/workflows/branch-deploy.yml) file and make any necessary changes if you wish to use it.\n\nThe `branch-deploy` Action will allow you to trigger branch deployments from pull requests by using comments such as `.deploy`.\n\n## Build Cache\n\nThis templates also uses a custom GitHub Actions build cache to help speed things up in CI when processing images. If you make any changes to images when working on a project using this template, please ensure to run `npm run build` before deploying to ensure your `cache.json` file is updated.\n\n## Using this Template\n\nYou should probably do a search through this repo and replace all occurances of `astro-demo.birki.io` with your own domain as well.\n\n## Making Changes\n\nThis section goes into details on how you can make changes to the template.\n\n## Live Commit Examples\n\nActual examples in the form of commits to this repository:\n\n- [Adding a new page](https://github.com/GrantBirki/astrowind/commit/6836c11a3140181a65f252e3709e398f67e632c4)\n\n## Acknowledgements\n\nThis theme is based off the template by [onwidget](https://github.com/onwidget/astrowind)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrantbirki%2Fastrowind-hard-fork","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrantbirki%2Fastrowind-hard-fork","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrantbirki%2Fastrowind-hard-fork/lists"}