Home

Awesome

:warning: We have moved staticgen.com to jamstack.org/generators

You can still contribute at https://github.com/jamstack/jamstack.org/ or join us on Slack at http://jamstack.slack.com/


staticgen.com

staticgen.com, a leaderboard of top open-source static site generators.

Netlify Status

Contributing

Missing a static site generator here? Just fork the repo and add your generator as a <name>.md in the content/projects folder.

Make sure to follow the following rules:

Usage

Be sure that you have the latest node and npm installed, then clone this repository and run:

npm install
npm start

In order to successfully retrieve Twitter followers and repository stars (GitHub or GitLab), you will need authentication keys for these services.

For GitHub, all you'll need is a personal access token with the repo and gist scopes. This can be generated at https://github.com/settings/tokens. For GitLab, you'll also need a personal access token. This can be generated at https://gitlab.com/profile/personal_access_tokens. For Twitter, you need to create an application at https://apps.twitter.com to get the necessary tokens. When deploying, you must set the environment variables per the example below. If you are developing locally, you can set these in a .env file at the root of the repo.

GITHUB_TOKEN=examplekey123abc
GITLAB_TOKEN-examplekey123abc
TWITTER_CONSUMER_KEY=examplekey231abc
TWITTER_CONSUMER_SECRET=examplekey321abc
TWITTER_ACCESS_TOKEN_KEY=examplekey231abc
TWITTER_ACCESS_TOKEN_SECRET=examplekey321abc

GitHub, GitLab, and Twitter data is cached in the .tmp directory, and online in a Gist. If neither has data newer than 24 hours old, fresh data is fetched from GitHub, GitLab, and Twitter. Fetching caching occur automatically during the build.

Then visit http://localhost:8000/ - Gatsby will automatically reload when changes occur.

To test a production build locally, do:

npm run stage
npm run serve

To run a production build for deployment:

npm run build

Netlify

StaticGen.com is built and maintained by Netlify, a hosting and automation service for static websites and apps.

License

StaticGen is released under the MIT License. Please make sure you understand its implications and guarantees.