Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/juliancataldo/web-garden
Building blocks for making progressive and future-proof websites. Components collection features Astro, HTML, SCSS, JS, TS… Configurations features ESLint, Prettier, Stylelint…
https://github.com/juliancataldo/web-garden
astro css frontend html javascript scss scss-mixins typescript vanilla-javascript
Last synced: about 1 month ago
JSON representation
Building blocks for making progressive and future-proof websites. Components collection features Astro, HTML, SCSS, JS, TS… Configurations features ESLint, Prettier, Stylelint…
- Host: GitHub
- URL: https://github.com/juliancataldo/web-garden
- Owner: JulianCataldo
- License: isc
- Created: 2022-06-18T02:54:16.000Z (over 2 years ago)
- Default Branch: develop
- Last Pushed: 2024-07-14T18:43:16.000Z (4 months ago)
- Last Synced: 2024-10-05T16:01:41.817Z (about 1 month ago)
- Topics: astro, css, frontend, html, javascript, scss, scss-mixins, typescript, vanilla-javascript
- Language: TypeScript
- Homepage: http://code.juliancataldo.com
- Size: 25.3 MB
- Stars: 156
- Watchers: 2
- Forks: 17
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 Julian's Web Garden
[](https://astro.build)
[](https://sass-lang.com)
[](http://www.typescriptlang.org/)
[](./LICENSE)
[](https://www.conventionalcommits.org)
[](https://makeapullrequest.com)
[](https://prettier.io)
[](https://editorconfig.org)
[](https://eslint.org)
[](https://stylelint.io)
---
Here lies some re-usable components and tooling settings,
taking advantage of Astro strengths as much as possible.
Focus is on common web patterns and progressive enhancements.
## 🤷🏼♂️ Philosophy
We've all been to the point of throwing valuable code when adopting new
shiny website frameworks.
Thanks to "island architecture" practices, we can establish standard and
future-proof, commonly used, generic patterns, using the web holy trinity of languages : **HTML** / **CSS** and **JavaScript**.
That way, we can sprinkle advanced JS widgets as we like, with trendy UI framework, while
things like global application utilities remain stable over time.
Vanilla means future-proofing our code, but it also bring the benefit of
minuscule file sizes compared to "all-or-nothing" UI frameworks.
---
- [🚀 Julian's Web Garden](#julians-web-garden)
- [🤷🏼♂️ Philosophy](#️philosophy)
- [🔗 Quick links](#quick-links)
- [LIVE DEMO 🎭 DOCUMENTATION WEBSITE ⎋](#live-demo--documentation-website)
- [Architecture](#architecture)
- [Terminology](#terminology)
- [📖 Website source code](#website-source-code)
- [📦 Application-level components](#application-level-components)
- [📦 Components](#components)
- [🛠 Tooling configurations](#tooling-configurations)
- [🚧 To dos](#to-dos)
- [🧑🚀 Development](#development)
- [🏁 Commands](#commands)
---
# 🔗 Quick links
## [LIVE DEMO 🎭 DOCUMENTATION WEBSITE ⎋](https://code.juliancataldo.com/)
[](https://code.juliancataldo.com)
[**Production** deployed on **`code.juliancataldo.com`**](https://code.juliancataldo.com/).
_[**Mirror** deployed on **`web-garden.netlify.app`**](https://web-garden.netlify.app)._
[See **Production** GitHub workflow](https://github.com/JulianCataldo/web-garden/blob/develop/.github/workflows/production.yml)
[**Develop** deployed on **`develop--web-garden.netlify.app`**](https://develop--web-garden.netlify.app).
[See **Branch** GitHub workflow](https://github.com/JulianCataldo/web-garden/blob/develop/.github/workflows/branch.yml)
Deployed on Netlify via GitHub actions.
### Architecture
```mermaid
flowchart TB
subgraph Pages
Home(Home)
Etc2("...")
end
subgraph Components
subgraph Layouts
Default('Default')
Etc3("...")
end
subgraph Application
SEO('SEO')
Prefetch('Prefetch')
Etc("...")
end
subgraph Modules
Landing('Landing')
SinglePackage('SinglePackage')
Etc5("...")
end
subgraph Generic
Link('Link')
LicensesReport('LicensesReport')
Etc4("...")
end
end
Data(Data)-->Pages
Application-->Layouts
Generic-->Pages
Modules-->Pages
Generic-->Modules
Generic-->Layouts
Layouts-->Pages
```
---
#### Terminology
- **Pages**: the base component entry point.
All other parts (**layouts**, generic **components**, **modules**…) and data are directly or indirectly gathered from here.
- **Layout**: Where your website shells lives. This is where you put your global navigation, footer…
Alternative layouts can be created like
`Print`, `Compact`, `Bare`, `Blog`…
- **App-level component**: used everywhere, anytime, for a given **layout**, which import them.
E.g. Color modes handler, breakpoints handler…
- **Component**: Ubiquitous general purpose, atomic components.
E.g. icons, images, links, maps, videos…
- **Module**: Complex set of components, forming a single purpose page view/section.
E.g. `Landing`, `SinglePackage`, `ContactForm`…
- **Data**: Local JSONs, Markdown files, remote APIs…
Should be fetched from **pages**. Note that this is not a hard rule or a technical limitation with Astro as with other frameworks.
Ultimately, this pattern makes data-flow easier to follow ("top -> down"), preventing spaghetti code, duplications and performance hogs.
## [📖 Website source code](https://github.com/JulianCataldo/web-garden/tree/master/demo)
See [default layout](demo/src/layouts/Default/Default.astro) and [home page](https://github.com/JulianCataldo/web-garden/blob/develop/demo/src/pages/index.astro)
for live implementation examples.
---
## [📦 Application-level components](https://github.com/JulianCataldo/web-garden/tree/develop/app)
[These are global components](https://github.com/JulianCataldo/web-garden/tree/develop/app) which enhance or augment browser behavior and style,
while providing useful utilities to developers, website-wide.
```
app/
├── BaseDocument/
├── Breakpoints/
├── ColorMode/
├── GoogleAnalytics/
├── HoverPrefetch/
├── Lightbox/
├── Navigation/
├── PageTransition/
├── Resets/
├── ScrollObserver/
├── SEOMetadata/
└── Tooltips/
```
## [📦 Components](https://github.com/JulianCataldo/web-garden/tree/develop/components)
Generic [extendables components](https://github.com/JulianCataldo/web-garden/tree/develop/components).
```
components/
├── CodeEditor/
├── Diagram/
├── GeoMap/
├── LicensesReport/
├── Link/
├── Tabs/
├── TerminalPlayer/
└── Testbed/
```
## [🛠 Tooling configurations](https://github.com/JulianCataldo/web-garden/tree/develop/configs)
[A useful collection](https://github.com/JulianCataldo/web-garden/tree/develop/configs) for web developers.
Features ESLint, Prettier, Stylelint, Commitlint…
For Astro, React, Vue, SCSS, TS…
```
configs/
├── vscode/
├── .editorconfig-example
├── commitlint-base.ts
├── eslint-all.cjs
├── eslint-astro.cjs
├── eslint-js.cjs
├── eslint-jsx.cjs
├── eslint-mdx.cjs
├── eslint-ts.cjs
├── eslint-tsx.cjs
├── eslint-vue.cjs
├── index.mjs
├── prettier-astro.cjs
├── prettier-base.cjs
└── stylelint-all.cjs
```
# 🚧 To dos
- [ ] Find a way to launch only necessary tests when versioning
- [ ] Implement dev / prod mode for debugging outputs
- [ ] Evaluate PNPM workspaces + tools for replacing Lerna version/publish?
- [ ] Fix Lerna conventional commits not following breaking changes for versioning
- [ ] Full no JS compatibility / fallbacks checks
- [ ] Fix CSS theme not loading
- [ ] Fix flash of unstyled text (critical font loading strategy)
# 🧑🚀 Development
## 🏁 Commands
```zsh
# Clone mono-repository
git clone https://github.com/JulianCataldo/web-garden
# Scripts located in root ./package.json
# Bootstrap all packages dependencies
pnpm install --recursive
# Launch implementations demo website
pnpm run demo
# Cypress: Open dev GUI
pnpm run cypress:open
# Cypress: Run test suite
pnpm run cypress:run
# Linkinator: Run links checker with report
pnpm run test:links
# Pre-release, does:
# 1. Packages bump based on commits
# 2. Tagging releases
# 3. Git push
pnpm run version
# Release updated packages on NPM public registry
pnpm run release
```