pudl

KO | EN

gitlite — search

#python #golang #go #android #machine-learning #linux #awesome #cli #kubernetes #awesome-list #pytorch #security #mcp #open-source

(★ 79)

🐶 A JavaScript-based Static Site Generator — for quick static site prototyping. Jamstack with Gulp.

pudl Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![pudl](https://maedahbatool.com/wp-content/uploads/2018/09/pudl-image.jpg)

[![npm](https://img.shields.io/npm/v/gulp-poodle.svg?style=flat-square&color=321A92&labelColor=7E57C3)](https://www.npmjs.com/package/gulp-poodle) [![npm downloads](https://img.shields.io/npm/dt/gulp-poodle.svg?style=flat-square&label=downloads&color=321A92&labelColor=7E57C3)](https://www.npmjs.com/package/gulp-poodle) [![HTML](https://img.shields.io/badge/pug-html-gray.svg?style=flat-square&color=321A92&labelColor=7E57C3)](https://www.npmjs.com/package/gulp-poodle) [![CSS](https://img.shields.io/badge/sass-css-gray.svg?style=flat-square&color=321A92&labelColor=7E57C3)](https://www.npmjs.com/package/gulp-poodle)

<table width='100%'>
    <tr>
        <td align='left' width='100%' colspan='2'>
            🎯  <code>pudl</code> is a JavaScript-based static site generator (SSG) for quick-prototyping and creating awesome little static demos while teaching/presenting. It significantly cuts down your dev-setup time and improves productivity. It also gives a nice developer experience.
        </td>
    </tr>
    <tr>
        <td>
            A FOSS (Free & Open Source Software) automation workflow project. Developed and Maintained by <a href='https://github.com/maedahbatool'>@MaedahBatool</a>.
        </td>
        <td align='center'>
            <a href='https://MaedahBatool.com'>
                <img src='https://img.shields.io/badge/→-MAEDAH%20BATOOL-gray.svg?colorB=5734F5&style=flat-square' width='100' />
            </a>
        </td>
    </tr>
</table>

## 🐶 What can `pudl` do?

1.  Live reloads browser with BrowserSync.
2.  CSS: Sass to CSS conversion, error catching, Autoprefixing and CSS minification.
3.  Watches files for changes in CSS.
4.  Corrects the line endings.
5.  InjectCSS instead of browser page reload.
6.  Sends message notification to you.
7.  Prevents pipe breaking caused by errors.

## 🔥 Getting started

<details>
 <summary><strong> STEP #0</strong> — Don't have <code>Node.js</code> + <code>npm</code> installed? Read this small guide. (CLICK TO EXPAND!)</summary>

In case you are an absolute beginner to `Node.js`, JavaScript, and `npm` packages — all you need to do is go to the Node's site [download + install](https://nodejs.org/en/download/) Node on your system. This will install both `Node.js` and `npm`, i.e., node package manager — the command line interface of Node.js.

You can verify a successful installation by opening your terminal app and then start typing...

```sh
node -v
# Results into v9.11.2 — please make sure you have Node >= 8 installed.

npm -v
# Results into v6.2.0 — please make sure you have npm >= 5.3 installed.
```

</details>

### ➡️ Step #1. Download the required files

Download the [`gulpfile.js`](https://raw.githubusercontent.com/MaedahBatool/pudl/master/dist/gulpfile.js), [`package.json`](https://raw.githubusercontent.com/MaedahBatool/pudl/master/dist/package.json), [`.gitignore`](https://raw.githubusercontent.com/MaedahBatool/pudl/master/dist/.gitignore), and [`config.js`](https://raw.githubusercontent.com/MaedahBatool/pudl/master/dist/config.js) files inside the root folder of your project.

_**OR** use your terminal to browse your desired folder and run the following command that downloads all the required files for you via cURL._

```sh
curl -L https://git.io/pudlgfl -o "gulpfile.js" && curl -L https://git.io/pudlpkjs -o "package.json" && curl -L https://git.io/pudlgig -o ".gitignore" && curl -L https://git.io/pudlcg -o "config.js"
```

### ➡️ STEP #2: Editing the project variables

Next, change the project variables in the `config.js` file according to your folder structure.

```js
// List of Project Variables.
module.exports = {
	viewSrc: './views/**/*.pug',
	viewDst: './',
	styleSrc: './css/style.scss',
	styleDst: './',
	outputStyle: 'compressed',
	viewWatchFiles: './views/**/*.pug',
	styleWatchFiles: './css/**/*.scss',
	browserAutoOpen: false,
	injectChanges: true
};
```

### ➡️ STEP #3: Installing the node dependencies

In the root folder of your development project install the Node Dependencies. In the terminal run the following command and wait for it to download all the `node.js` dependencies. It's a one-time process and can take about 5 minutes or more depending on the speed of your internet connection.

```sh
# For MAC OS X run the following command with super user.
npm install

# For Linux run the following command.
npm install
```

### ➡️ STEP #4: Run `npm start`

Finally, run the following command to get up and running with pudl.

```sh
# To start pudl
npm start

# To stop pudl press CTRL (⌃) + C
```

Now `gulp` will start watching your `pug` and `sass` files for any changes and provides you with a link through which you can access your site locally. The localhost link can be accessed by `http://localhost:3000/`.

## Licensing

Released under GNU GPLv2.0 or later license.
Copyright [Maedah Batool](https://twitter.com/MaedahBatool)

---

### 🙃 **Hello, we're the [Dev Couple](https://TheDevCouple.com)**!

[Ahmad Awais](https://twitter.com/mrahmadawais/) (my husband) is an OSS developer advocate, Full Stack Web Developer and a regular core contributor at WordPress. I ([Maedah Batool](https://twitter.com/MaedahBatool/)) is a Technical Content Program Manager, and I'm also a WordPress Core Contributor. Together with our [team](https://TheDevCouple.com/team), we run the [TheDevCouple.com](https://TheDevCouple.com/).

If you'd like to get insights into our love for open source software, professional full stack development, WordPress community, the growth of JavaScript or growing a family, building, and bootstrapping a business, then subscribe to our newsletter called ↣ [The Developers Takeaway](http://thedevtakeaway.ahmadawais.com/)!

#### [**Support our Open Source Projects!**](https://pay.paddle.com/checkout/515568) 🎩

If you'd like us to keep producing professional free and open source software (FOSS). Consider [paying for an hour of my dev-time](https://pay.paddle.com/checkout/515568). We'll spend two hours on open source for each contribution. Yeah, that's right, you pay for one hour and get both of us to spend an hour as a thank you.

-   🚀 $99.99 — [Support for one hour or more →](https://pay.paddle.com/checkout/515568)
-   🔰 $49.99 — [Support half an hour maintenance →](https://pay.paddle.com/checkout/527253)
-   ☕️ $9.99 — [Buy us lunch or coffee to keep us trucking #OpenSource →](https://pay.paddle.com/checkout/527254)

<br>

### 🙌 [THEDEVCOUPLE OSS PARTNERS](https://TheDevCouple.com/partners)

This open source project is maintained and supported by the help of awesome companies listed below. [Read more about it here →](https://TheDevCouple.com/partners)

_Follow me 👋 on Twitter for more updates and questions_ →  [![Tweet to say Hi](https://img.shields.io/twitter/follow/maedahbatool.svg?style=social&label=Tweet%20@MaedahBatool)](https://twitter.com/maedahbatool)

pudl

pudl Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

pudl

pudl Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README