Create Static Site
Create static websites with no build configuration.
npx create-static-site my-site --template hugo cd my-site npm start
(npx comes with npm 5.2+ and higher)
Then open http://localhost:3000/ to see your app.
Creating a Static Site
To create a new app, run:
npx create-static-site my-site --template [template]
[template] with either
It will create a directory called
my-site inside the current folder.
Inside that directory, it will generate the initial project structure and install the transitive dependencies:
my-site ├── LICENSE ├── node_modules ├── package.json ├── README.md ├── static-scripts.config.js ├── .browserslistrc ├── .eslintrc.yml ├── .gitignore ├── .postcssrc.js ├── .stylelintrc.yml ├── site/ # Depends on the static site generator └── src/ ├── css/ │ ├── styles.css │ └── imports │ └── resets.css ├── img/ │ └── svg/ │ ├── bitbucket.svg │ ├── github.svg │ └── gitlab.svg └── js/ ├── scripts.js └── imports/ └── index.js
No configuration or complicated folder structures, just the files you need to build your site.
Once the installation is done, you can open your project folder:
Inside the newly created project, you can run some built-in commands:
npm start or
Jekyll users will need to run
bundle install first
Runs the app in development mode.
Open http://localhost:3000 to view it in the browser.
The page will automatically reload if you make changes to the code.
npm build or
Builds the site for production to the
One Dependency: There is just one build dependency. It uses Webpack, Babel, ESLint, PostCSS, and other amazing projects, but provides a cohesive curated experience on top of them.
No Configuration Required: You don't need to configure anything. Reasonably good configuration of both development and production builds is handled for you so you can focus on writing code.
No Lock-In: You can “eject” to a custom setup at any time. Run a single command, and all the configuration and build dependencies will be moved directly into your project, so you can pick up right where you left off.
Your environment will have everything you need to build a modern static website:
- A Static Site Generator (Jekyll or Hugo)
- Language extras beyond ES6, like object spread operator.
- Autoprefixed CSS
- Hassle-free updates for the above tools with a single dependency.
The tradeoff is that these tools are preconfigured to work in a specific way. If your project needs more customization, you can "eject" and customize it, but then you will need to maintain this configuration.
Static sites are websites built using static, unchanging files. Because the content is static, delivering it to users requires no server processing time. This feature makes static sites incredibly fast and performant.
Static site generators are the modern way of building static sites. They convert simple, text-based content files in static files ready for the web.
They’re fantastic for developers because they are extremely fast, are built to work with version-control, and require little-to-no setup compared to existing monolithic CMS solutions like Wordpress.
create-static-site supports two static site generators:
- Jekyll is the static site generator written in Ruby and created by GitHub founder, Tom Preston Werner.
- Hugo is the static site generator written in GoLang and created by Steve Francia.
We'd love to have your helping hand on
create-static-site! See CONTRIBUTING.md for more information on what we're looking for and how to get started.
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
This project is greatly inspired by the wonderful create-react-app project.