Skip to content

feat: new website - #481

Open
ilteoood wants to merge 15 commits into
mainfrom
feat/new-website
Open

feat: new website#481
ilteoood wants to merge 15 commits into
mainfrom
feat/new-website

Conversation

@ilteoood

Copy link
Copy Markdown
Member

Description

As discussed, this PR is to introduce here the new website.

Related Issues

Check List

Comment thread scripts/fetch-docs.mjs Fixed
Comment thread scripts/download-benchmarks.mjs Dismissed
Comment thread scripts/fetch-docs.mjs Dismissed
Comment thread scripts/fetch-plugin-downloads.mjs Dismissed
@ilteoood ilteoood changed the title feat: new website [WIP] feat: new website Aug 12, 2026
@Puppo

Puppo commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

👏

Astro exposes BASE_URL verbatim from the base config; with base: '/'
that meant withBase('/ecosystem') returned '//ecosystem', which the
browser resolves as the protocol-relative URL http://ecosystem and
navigates away from the site.
@ilteoood ilteoood changed the title [WIP] feat: new website feat: new website Aug 13, 2026
@ilteoood

Copy link
Copy Markdown
Member Author

@fastify/core @fastify/collaborators this is now ready to be reviewed!

@Tony133

Tony133 commented Aug 13, 2026

Copy link
Copy Markdown
Member

One question: shouldn't we exclude the .agents and .claude folders and the skills-lock.json file from the repository and put them in .gitignore ? 🤔

Otherwise, LGTM is fine 🔥 🚀 ✅

@ilteoood

Copy link
Copy Markdown
Member Author

One question: shouldn't we exclude the .agents and .claude folders and the skills-lock.json file from the repository and put them in .gitignore ? 🤔

Otherwise, LGTM is fine 🔥 🚀 ✅

@Tony133 I kept them just because those are the "rules" we need to keep style coherent when we will change in the future

@Tony133

Tony133 commented Aug 13, 2026

Copy link
Copy Markdown
Member

@Tony133 I kept them just because those are the "rules" we need to keep style coherent when we will change in the future

ok 👍🏻

@Tony133 Tony133 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@ilteoood
ilteoood requested a review from a team August 13, 2026 10:21

@gurgunday gurgunday left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@jean-michelet jean-michelet left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't request changes because I disagree, just wait to have some time to review this very large diff.

@jean-michelet

Copy link
Copy Markdown
Member

I don't think we should keep Agent files here, or we should ask why they are relevant on this repository and not the others?

@ilteoood

ilteoood commented Aug 13, 2026

Copy link
Copy Markdown
Member Author

I don't think we should keep Agent files here, or we should ask why they are relevant on this repository and not the others?

I've answered here to this question.
It's not something I would die for, but at least helps us keeping some coherence

@jean-michelet

Copy link
Copy Markdown
Member

I've answered #481 (comment) to this question.

This answer is valid for any repository of the org.
Maybe we should have a repository with all our skills, like did Matteo here: https://github.com/mcollina/skills
Then collaborators and end-users can reuse them.

@ilteoood

ilteoood commented Aug 13, 2026

Copy link
Copy Markdown
Member Author

This answer is valid for any repository of the org.

I disagree with this. In the other repositories of the fastify's org, whatever way in which you code is fine: the important thing is the result you bring in.
Here the story is different: for a website, the style and the way in which items are positioned must be coherent with the rest to still have a good appeal.
If a feature contributor implement things in a completely different style because is using a different set of skills the result could be compromised.

@jean-michelet

jean-michelet commented Aug 13, 2026

Copy link
Copy Markdown
Member

In the other repositories of the fastify's org, whatever way in which you code is fine

No, but the Agent "understand" the context of the project so it guesses mostly right how to perform an update of the code base.

for a website, the style and the way in which items are positioned must be coherent with the rest to still have a good appeal.

I don't think this would be different for a website, the agent is gonna "wonder" how to implement things coherently with the existing.

I personally don't care if we keep specific skills in some repositories, but I don't see it as more necessary for the website then some other plugins with sensible logic.
So having the more general discussion about reusable skills across the org is still valuable imo.

@Eomm

Eomm commented Aug 13, 2026

Copy link
Copy Markdown
Member

My POV:
While collaborators are strong plugin writers, we're (?) (I'm - for sure) mostly shitty frontend coders and designers, so the .agents/ stuff gives me the freedom to contribute more, or at least not to break things or make them ugly.

For example, the aria stuff: I know it exists, but I don't know how to add it correctly.

@Tony133

Tony133 commented Aug 13, 2026

Copy link
Copy Markdown
Member

As I imagined, the .claude and .agents folders are causing some discussion 😄

I checked the fastify-plugins and fastify-libraries repositories, and folders such as .claude are generally excluded. For example, see @mcollina’s PR: fastify/fastify-swagger#909

Not all .gitignore files currently exclude folders such as:

.claude
.agents
etc.

but we can easily add them.

If this repository is an exception, we can of course let it slide. That said, I don't think folders such as .claude, .agents, etc. should be committed to the various plugin and library repositories. IMO, they should be excluded through .gitignore.

In any case, I'd follow what @mcollina is doing. If he is excluding these folders, I think it makes sense for us to follow the same approach across the repositories. 🙂

As for the website, the skills could be moved to a separate repository (fastify/skills) if desired. I believe that decision is ultimately up to the @fastify/website team.

Most importantly, I don't think this PR should be blocked by three "AI folders" 😄, especially given the time and effort that has already gone into it. If these folders are the main issue preventing the new site from being released, we can temporarily exclude them and move forward. 🚀

@jean-michelet

Copy link
Copy Markdown
Member

Most importantly, I don't think this PR should be blocked by three "AI folders" 😄,

It is not. I just kindly ask to get the opportunity to review the website content, as it concerns every collaborator.

@Tony133

Tony133 commented Aug 13, 2026

Copy link
Copy Markdown
Member

Most importantly, I don't think this PR should be blocked by three "AI folders" 😄,

It is not. I just kindly ask to get the opportunity to review the website content, as it concerns every collaborator.

ok 😄👍🏻

@jean-michelet

Copy link
Copy Markdown
Member

I checked the fastify-plugins and fastify-libraries repositories, and folders such as .claude are generally excluded. For example, see @mcollina’s PR: fastify/fastify-swagger#909

I’m not familiar with every convention around skills, and I don’t have a strong opinion about which directory they use. My concern is that .claude and .agents can contain more than reusable skills, like personal context. I believe this is why these directories are ignored, especially since contributors have accidentally pushed them in PRs before.

We could still explicitly track repository-specific skills. But the skills in this PR seems to be generic third-party skills. They are in skills-lock.json and can be installed through CLI, so I don't know if we need to commit the generated directories as well or just add a script to generate them and mention it in the contributor guide.

I am pro AI personally, (like I am pro TS, ESM and a lot of other things), but this is not the case of every contributor so I care about their feedback too. It's not just me wanting to annoy people about AI files.

@jean-michelet jean-michelet left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks good overall.

Minor suggestion: perhaps we should avoid em dashes (—). They are perfectly valid punctuation, but many people now strongly associate them with AI slope.

Comment on lines +39 to +40
Fast and low overhead.<br />
<span class="text-velocity">For Node.js.</span>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This sounds slightly awkward, and the original wording A fast, low-overhead web framework for Node.js. (IMO was much better) seems to have been sacrificed for styling reasons.

Comment on lines +45 to +46
with the least overhead. A powerful plugin architecture, schema-based
speed, and one of the fastest cores in Node.js.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

schema-based speed, and one of the fastest cores in Node.js.

I think it's very unclear what that means.

Maybe something like this?

Fastify is a web framework focused on delivering the best possible developer experience with minimal overhead and a powerful plugin architecture.

<h2
class="mt-4 font-display text-3xl font-semibold tracking-tight sm:text-4xl"
>
Built on solid principles

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section mixes concrete features with broader principles and qualities, so neither former "Core features" nor "Built on solid principles" fully describes it.

I think "Core strengths" or similar would be more accurate. It also avoids possible confusion with Robert C. Martin’s SOLID principles 😆

Comment thread src/data/site.ts
invert?: boolean;
};

export const SPONSORS: Sponsor[] = [

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

On a lot of websites, we not only mention sponsors, but also major companies using the framework.

@fastify/collaborators Are you aware of big tech or other relevant tech companies using the framework?

We could perform a deep search with an agent to retrieve evidences of companies mentioning using Fastify.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are you aware of big tech or other relevant tech companies using the framework?

We can't do that - this was another debate.

Once upon a time, a Microsoft dev was on the team and we had the MS logo on the website, but when he moved to another job, we had to remove it.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can't do that - this was another debate.

Because we're part of OpenJS?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants