Giter Club home page Giter Club logo

wodle's Introduction

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

wodle's People

Contributors

ggamel avatar lucas-aragno avatar michael-sb avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

Forkers

ggamel michael-sb

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.