Skip to content

Update Tropical description #612

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
zachleat merged 1 commit into from
Jul 21, 2021
Merged

Update Tropical description #612

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 4 additions & 6 deletions src/site/generators/tropical.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,14 +8,12 @@ license:
- MIT
templates:
- React
description: Use modern tools to build fast, mostly-just-HTML websites with islands of rich client-side behaviour.
description: Use modern tools to build fast, mostly-just-HTML websites with islands of client-side JS.
startertemplaterepo: https://github.com/bensmithett/tropical
---

Tropical is a flexible, component-first static site generator that lets you use modern tools to build fast, mostly-just-HTML websites with islands of rich client-side behaviour.
Tropical is a modern static site generator without complex magic.

Tropical gives you modern tools like React and Storybook, but acknowledges that content-heavy sites often don't need the truckload of extra client-side features that are often included in a React project. Sometimes a simple HTML file for each page is all you need!
It's just [Vite](https://vitejs.dev/) plus a layer of **familiar, industry-standard tools & conventions** (like React, Storybook, MDX & Fela) for building *fast*, mostly-just-HTML websites with [islands](https://jasonformat.com/islands-architecture/) of targeted client-side JS.

When you do need client-side behaviour, Tropical makes it easy to progressively enhance your prerendered HTML with anything from a sprinkling of vanilla JS up to targeted rehydration of prerendered isomorphic React components.

It's also written as a template repo by default. Rather than hiding the framework and Webpack configuration in an NPM package black box, the simple core files of Tropical are intended to be changed, learned from and hacked to suit your needs!
It's also **just a [template repo](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/creating-a-repository-from-a-template)**. There's no library to install or configure. You're not stuck with these features. If [Vite can do it](https://vitejs.dev/guide/features.html), so can your Tropical site.