starbase
4.0.0
Starbase é um modelo de site estático pronto para produção com Webpack 5, TypeScript, PostCSS e Tailwind CSS que foi projetado para integração com provedores de hospedagem Jamstack modernos, como Vercel, Netlify e AWS Amplify. Comece a construir em minutos com algumas das tecnologias front-end mais poderosas disponíveis em 2024, alimentadas por uma experiência de desenvolvedor deliciosamente simples e repleta de recursos.
Starbase foi criado por Brian Staruk como um guia de estilo de código pessoal e um modelo de projeto flexível. É um trabalho perpétuo em andamento que tem sido mantido de forma consistente desde o início de 2017, com foco na implementação dos padrões mais recentes do setor e na manutenção de todas as dependências atualizadas.
"Simplicidade é a sofisticação máxima."
-Leonardo da Vinci
A missão principal do Starbase é ser sofisticadamente simples; fácil de configurar, estender e integrar. Isso também o torna uma ótima plataforma para desenvolvedores da web aprimorarem seu conhecimento sobre configurações bare-metal do Webpack, TypeScript e/ou Tailwind CSS.
Para começar, execute o comando abaixo, que o guiará pelo processo de instalação:
npx starbase@latest É recomendado usar nvm (ou nvm-windows) para gerenciar as instalações da versão Node. Se você não usar o nvm, precisará consultar o arquivo /.nvmrc para verificar se sua versão do Node é compatível com a versão recomendada.
Comece garantindo que você está executando a versão recomendada do Node e instalando as dependências do projeto:
nvm use
npm install O comando dev servirá a fonte do projeto em http://localhost:3000. Quaisquer alterações feitas em /src recompilarão o código-fonte e atualizarão seu navegador.
npm run dev O comando build irá compilar e reduzir a origem do projeto em /dist para integração ou implantação.
npm run buildStarbase está configurado para ser implantado na raiz de um servidor web em um ambiente de hospedagem como Vercel, Netlify, etc. Como tal, todos os ativos (js, css, fontes, imagens, etc) são referenciados com caminhos absolutos.
Se você quiser fazer referência a ativos por meio de caminhos relativos, para que os arquivos .html compilados possam ser distribuídos e abertos em um navegador da Web sem exigir uma implantação em um ambiente de hospedagem, você precisará remover (ou comentar) o publicPath em /webpack/webpack.config.base.ts .
Se desejar manter os caminhos absolutos, mas defini-los como um subdiretório em vez da raiz, você pode alterar o valor em vez de removê-lo.
Starbase é um software gratuito e de código aberto. Por favor, construa coisas incríveis com ele. Você pode me pagar uma cerveja na próxima vez que estiver em Boston, estrelar o projeto e contar a um amigo, ou pode apagar todos os sinais de origem e dizer aos seus colegas de trabalho que você mesmo fez isso. Está tudo bem!
