web-infra-dev / rspress

🦀💨 A fast Rspack-based static site generator.
https://rspress.dev
MIT License
1.48k stars 139 forks source link

[Feature]: Add the option to init a barebone template #1468

Open YanPes opened 1 month ago

YanPes commented 1 month ago

What problem does this feature solve?

When setting up a new rspress page, there is a lot of predefined styling with high specificity. Although this can be good in some use cases, it is cumbersome if you want to fully customize the styling. This needs either overriding predefined styles or creating all elements with custom MDX components.

I would like to have the option to select if I want the default init or a barebone init which strips away all the branding.

What does the proposed API look like?

An additional step when starting the CLI wizard with npm create rspress@latest

Choose your template:

Timeless0911 commented 1 month ago

This is impossible due to the default theme, you can customize it by yourself.

We will consider more pluggable designs in future about theme designs.

chenjiahan commented 1 month ago

@Timeless0911 I believe this is a reasonable proposal, currently create-rspress only provides one template, which is not enough. We can refactor create-rspress with https://github.com/rspack-contrib/create-rstack and provide more templates for different use cases.

Timeless0911 commented 1 month ago

custom (core functionality without branding and styling)

What is without branding and styling mean? Do you want to not use any UI capabilities?

YanPes commented 1 month ago

Thank you for your fast replies.

The idea of adding multiple theming options would already help a lot for different scenarios.

My initial idea was treating the theming of rspress a bit like chadcn-ui look and feel. Very minimalistic and basic, almost like a high fidelity wireframe mock.

In the end it is all about improving the DX for the consumers so I really resonate with the idea of adding create-rstack as step wizard.

Timeless0911 commented 1 month ago

Thanks for your detailed explanation, we will enrich more templates for users in different scenarios in the future.