Skip to content

lucas-aragno/wodle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wodle

Wodle is a static site generator using new frameworks and tools for modern web development. It's built on top of Next.js and Tachyons. And you can easily turn the generated static site into a fully dynamic website.

Why?

Because NextJS and functional CSS make super easy to get started with a blog or a static page so it's a good starting point for bloggers and dev that wants to learn those technologies.

Installation

You can install Wodle via npm:

npm install -g wodle

Getting started

Once Wodle is installed, you can use the wodle command. To build a new site you can run:

wodle myBlog

That will generate a new site called myBlog on the same directory where you ran the command

To get started with your new site you just need to cd into it and then install the dependencies:

cd myBlog
yarn

That will fetch all the dependencies, once that's ready you can start a server running:

yarn dev

And go to localhost:3000/, you should see a site like this one:

That server will listen to changes on your app and reload the browser.

If you want to run your site without the hot-reloading you can run:

yarn start

Build your site

To build your site you can run:

yarn build

which will generate an out/ folder with your static site ready to be published.

How it works?

Your site will have different folders:

Pages Folder

This folder contains your pages files and their names matches their routes, so if you want to add a new page on /new-page you will need to add a new component on this folder called new-page.js. For advanced routing check here.

The scaffold comes with some page components prebuilt on the components folder.

Components Folder

In this folder you will find all the pre-built components on the site, the core components of this scaffold app are:

  • SideBar

A sidebar component that gets items and renders a Nav with their NavItems, the content for this component it's on content/sideBarOptions.js

  • Main

This components just wraps whatever you want to display on the main section (the center of the site).

  • MainArticle

This component renders the main Article, as you see on the index and each particular article. A demo of the content that can be processed by this component it's on content/mainArticle.

  • ArticleList

This component renders a list of articles as you will see on each individual page from the sidebar menu, you can see the lists on content/ on the <something>Articles.js files

among others

Styles Folder

Your styles folder is for all your css (right now almost empty thanks to functional CSS and Tachyons)

Extending the Site

You can continue deleting pages (removing files from the pages folder) adding more pages, articles, options following the patterns on the scaffold or just change everything as you want! You can read great guides on Next.js site and Tachyons to make your awesome website or blog!

based on previous art chibicode.com and jspg

Releases

No releases published

Packages

No packages published