Starbase est un modèle de site Web statique prêt pour la production comprenant Webpack 5, TypeScript, PostCSS et Tailwind CSS, conçu pour s'intégrer aux fournisseurs d'hébergement Jamstack modernes tels que Vercel, Netlify et AWS Amplify. Commencez à créer en quelques minutes avec certaines des technologies frontales les plus puissantes disponibles en 2024, optimisées par une expérience de développement délicieusement simple et complète.
Starbase a été créé par Brian Staruk en tant que guide de style de code personnel et modèle de projet flexible. Il s'agit d'un travail perpétuel en cours qui a été constamment maintenu depuis début 2017 en mettant l'accent sur la mise en œuvre des dernières normes de l'industrie et la mise à jour de toutes les dépendances.
"La simplicité est la sophistication ultime."
- Léonard de Vinci
La mission principale de Starbase est d'être d'une simplicité sophistiquée ; facile à configurer, à étendre et à intégrer. Cela en fait également une excellente plate-forme permettant aux développeurs Web d'améliorer leurs connaissances des configurations Webpack bare-metal, TypeScript et/ou Tailwind CSS.
Pour commencer, exécutez la commande ci-dessous, qui vous guidera tout au long du processus d'installation :
npx starbase@latest
Il est recommandé d'utiliser nvm (ou nvm-windows) pour gérer vos installations de versions Node. Si vous n'utilisez pas nvm, vous devrez vous référer au fichier /.nvmrc
pour vérifier que votre version de Node est compatible avec la version recommandée.
Commencez par vous assurer que vous exécutez la version recommandée de Node et installez les dépendances du projet :
nvm use
npm install
La commande dev
servira la source du projet à l'adresse http://localhost:3000. Toute modification apportée dans /src
recompilera la source et actualisera votre navigateur Web.
npm run dev
La commande build
compilera et réduira la source du projet dans /dist
pour l'intégration ou le déploiement.
npm run build
Starbase est configuré pour être déployé à la racine d'un serveur Web sur un environnement d'hébergement comme Vercel, Netlify, etc. En tant que tel, tous les actifs (js, css, polices, images, etc.) sont référencés avec des chemins absolus.
Si vous souhaitez plutôt référencer des actifs via des chemins relatifs, afin que les fichiers .html
compilés puissent être distribués et ouverts dans un navigateur Web sans nécessiter de déploiement sur un environnement d'hébergement, vous devrez supprimer (ou commenter) le publicPath
dans /webpack/webpack.config.base.ts
.
Si vous souhaitez conserver les chemins absolus, mais le définir sur un sous-répertoire au lieu de la racine, vous pouvez modifier la valeur au lieu de la supprimer.
Starbase est un logiciel open source gratuit. S'il vous plaît, construisez des choses géniales avec. Vous pouvez m'acheter une bière la prochaine fois que vous serez à Boston, lancer le projet et en parler à un ami, ou vous pouvez effacer toutes les traces d'origine et dire à vos collègues que vous l'avez fabriquée vous-même. Tout va bien !