From aafbaca2f4c03361b0a61401890ad7c1a2e6108f Mon Sep 17 00:00:00 2001 From: somrat sorkar Date: Tue, 18 Jul 2023 09:47:53 +0600 Subject: [PATCH] update readme, and packages --- netlify.toml | 4 +-- package.json | 14 +++++------ readme.md | 69 ++++++++++++++++++++++++++++++++++++++++++++++------ 3 files changed, 71 insertions(+), 16 deletions(-) diff --git a/netlify.toml b/netlify.toml index c5bc70b..f116ed9 100755 --- a/netlify.toml +++ b/netlify.toml @@ -1,8 +1,8 @@ [build] publish = "public" -command = "yarn project-setup && yarn build" +command = "yarn project-setup; yarn build" [build.environment] -HUGO_VERSION = "0.115.1" +HUGO_VERSION = "0.115.3" GO_VERSION = "1.20.5" HUGO_BASEURL = "/" diff --git a/package.json b/package.json index 237dc77..9401cf1 100644 --- a/package.json +++ b/package.json @@ -1,14 +1,14 @@ { "name": "hugoplate", "description": "hugo tailwindcss boilerplate", - "version": "1.5.0", + "version": "1.5.1", "license": "MIT", "author": "zeon.studio", "scripts": { - "dev": "hugo server", + "dev": "hugo server --disableFastRender", "build": "hugo --gc --minify --templateMetrics --templateMetricsHints --buildDrafts --buildExpired --buildFuture --forceSyncStatic", "test": "hugo server --disableFastRender --navigateToChanged --templateMetrics --templateMetricsHints --buildDrafts --buildExpired --buildFuture --watch --forceSyncStatic -e production --minify", - "dev:example": "cd exampleSite; hugo server", + "dev:example": "cd exampleSite; hugo server --disableFastRender", "build:example": "cd exampleSite; hugo --gc --minify --templateMetrics --templateMetricsHints --buildDrafts --buildExpired --buildFuture --forceSyncStatic", "test:example": "cd exampleSite; hugo server --disableFastRender --navigateToChanged --templateMetrics --templateMetricsHints --buildDrafts --buildExpired --buildFuture --watch --forceSyncStatic -e production --minify", "update-modules": "node ./scripts/clearModules.js && hugo mod clean --all && hugo mod get -u ./... && hugo mod tidy", @@ -19,15 +19,15 @@ }, "devDependencies": { "@fullhuman/postcss-purgecss": "^5.0.0", - "@tailwindcss/forms": "^0.5.3", + "@tailwindcss/forms": "^0.5.4", "@tailwindcss/typography": "^0.5.9", "autoprefixer": "^10.4.14", - "postcss": "^8.4.25", + "postcss": "^8.4.26", "postcss-cli": "^10.1.0", "prettier": "^2.8.8", "prettier-plugin-go-template": "0.0.13", - "prettier-plugin-tailwindcss": "^0.3.0", + "prettier-plugin-tailwindcss": "^0.4.1", "tailwind-bootstrap-grid": "^5.0.1", - "tailwindcss": "^3.3.2" + "tailwindcss": "^3.3.3" } } diff --git a/readme.md b/readme.md index db14018..7effe37 100755 --- a/readme.md +++ b/readme.md @@ -53,39 +53,94 @@ - πŸ—‚οΈ Category Single - πŸ” Search +--- + ## πŸš€ Getting Started -### πŸ“¦ Dependencies +First you need to `clone` or `download` the template repository, and then let's get started with the following process: -- Hugo v0.115.1+ +### βš™οΈ Prerequisites + +To start using this template, you need to have some prerequisites installed on your machine. + +- Hugo Extended v0.115+ - Node v18+ - Npm v9.5+ -- Go v1.20.5+ +- Go v1.20+ ### πŸ‘‰ Project Setup -``` +We build this custom script to make your project setup easier. It will create a new Hugo theme folder, and clone the Hugoplate theme into it. Then move the exampleSite folder into the root directory. So that you can start your Hugo server without going into the exampleSite folder. Use the following command to setup your project. + +```bash npm run project-setup ``` ### πŸ‘‰ Install Dependencies -``` +Install all the dependencies using the following command. + +```bash npm install ``` ### πŸ‘‰ Development Command -``` +Start the development server using the following command. + +```bash npm run dev ``` +--- + +## πŸ›  Advanced Usage + +We have added some custom scripts to make your life easier. You can use these scripts to help you with your development. + +### πŸ‘‰ Update Modules + +We have added a lot of modules into this template. You can update all the modules using the following command. + +```bash +npm run update-modules +``` + +### πŸ‘‰ Remove Dark Mode + +If you want to remove dark mode from your project, then you had to do it manually from everywhere. So we build a custom script to do it for you. you can use the following command to remove dark mode from your project. + +```bash +npm run remove-darkmode +``` + +--- + +## πŸš€ Build And Deploy + +After you finish your development, you can build or deploy your project to almost everywhere. Let's see the process: + ### πŸ‘‰ Build Command -``` +To build your project locally, you can use the following command. It will purge all the unused CSS and minify all the files. + +```bash npm run build ``` +### πŸ‘‰ Deploy Process + +We have provided 4 different platform deploy platform configuration with this template, so you can deploy easily. + +- Netlify +- Vercel +- Github Pages +- Gitlab Pages + +And if you want to Host some other hosting platforms. then you can build your project, and you will get a `public` folder. that you can copy and paste on your hosting platform. + +--- + ## 🐞 Reporting Issues We use GitHub Issues as the official bug tracker for this Template. Please Search [existing issues](https://github.com/zeon-studio/hugoplate/issues). It’s possible someone has already reported the same problem.