Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

What we want to provide on this showcase website #1

Open
AugustinMauroy opened this issue Dec 11, 2024 · 2 comments
Open

What we want to provide on this showcase website #1

AugustinMauroy opened this issue Dec 11, 2024 · 2 comments
Labels

Comments

@AugustinMauroy
Copy link
Member

AugustinMauroy commented Dec 11, 2024

Decide what you're going to put online, because it defines what you're going to use as tech.
I think the watchword is ‘keep it simple’.

BTW, we will deploy it with GA on GitHub pages. Because it costs nothing at all 😄

@AugustinMauroy
Copy link
Member Author

AugustinMauroy commented Dec 11, 2024

IMO Showcase Website Requirements

Essential Pages:

  • Landing Pages: To attract and engage visitors.
  • About Pages: To provide information about our mission, team, and values. (security, lightweight, efficiency)
  • Packages Pages: Requires NPM API integration, so we need Server-Side Rendering (SSR).

Optional (Based on Maintenance Costs):

  • Blog/News Section: To share updates and articles.
    • RSS Feeds: To enable users to subscribe to updates.

Exclusions:

  • i18N (Internationalization): Not need at all

Possible tools

  • Next.js: Very powerful, so you can do what you want, but high maintenance costs.
  • docusaurus: Great abstraction layer, not much to maintain, extensible with react component.
  • mintlify: This tool is built on top of next.js. I don't think it's a good idea, because the same project (nextra) has died, so it doesn't make me want to go dark with it.
  • astro: It's a meta framwork known for content first and supports all possible front end libraries. Very useful but I find it a bit messy due to the support for everything and anything.
  • vitrepress: A tool for writing docs, not very pretty but effective. Based on vue

@AugustinMauroy
Copy link
Member Author

I'd like to go to next.js because I'm very comfortable with it. And it lets you do what you need. I'm ready to start on a first design

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

1 participant