npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@ff0000-ad-tech/tmpl-build-sources

v1.0.1

Published

[![npm (tag)](https://img.shields.io/npm/v/@ff0000-ad-tech%2Ftmpl-build-sources.svg?style=flat-square)](https://www.npmjs.com/package/@ff0000-ad-tech%2Ftmpl-build-sources) [![GitHub issues](https://img.shields.io/github/issues/ff0000-ad-tech/tmpl-build-so

Downloads

3

Readme

RED Interactive Agency - FF0000 Ad Tech

npm (tag) GitHub issues npm downloads

GitHub contributors npm license PRs Welcome

tmpl-build-sources

Getting Started

REST API + Postman

Build Source Management

Overview

This project generates FF0000 Ad Tech Ad Templates, per requested:

  • Platform (DCM, DC Studio, Velvet, Flashtalking, Sizmek, Atlas, Monet, etc)
  • Type (Standard Polite, Intro/Endframe, Expandable, etc)
  • Options (Date Management, Video Players, Tracking Pixels, etc)

Build Sources are the code-snippets that are assembled together to create the requested Ad Templates. The relationships are modeled using json-based files, called stub.json. The insertions are denoted by a "template hook" system. For more information about about how Build Sources work, see Build Source Management.

Getting Started

  1. NPM Install this project
  2. Run Build Source Server
  3. Preview: Platforms, Types, and Options
  4. Download: Sizes for Development

System Dependencies

Make sure your machine has at least these versions installed:

  • Node ^9.0.0
  • NPM ^6.0.0
  • Python ^2.7.0

You can check your versions in Terminal (or shell of preference): Execute commands node -v, npm -v, and python to see which versions you're running. If you need to update or install, check online for instructions for your operating system.

Install Project

Clone or Download this repo and unzip it. In Terminal, cd into the result directory, then:

npm install

Build Source Server

Build Source Server will give you an interface to generate browser-runnable ads from the Build Source stubs.

Run it with this command:

npm start

Preview

Preview provides a way to quickly verify edits to Build Source stubs. They are organized accordian-style by

  • Platform
  • Type
  • Options

Select what you wish to preview, and click .

The following processes will happen:

  1. Render Build Source
  2. NPM Install top / build packages
  3. Launch Creative Server
  4. Run Traffic-compile

Once complete, the will become clickable. That means a Creative Server is running and has a 3-traffic/ folder to serve as a preview.

Download

Download generates clean, uninstalled templates. Use these for ad development!

Select what you wish to download, and click the "Download" button. You will be prompted for a size.

REST API + Postman

Build Source Server exposes a REST API for executing functionality. Postman is a tool that lets you craft & save HTTP requests. Once the server is running, you can use the API + Postman together to save & execute commands.

Making requests in this manner is useful for:

  • modifying & testing the actual Build Source layer
  • keeping ecosystem templates up-to-date by mapping renders to any location in your ecosystem

For all routes, refer to ./routes/api.js.

Build Source Requests

Requests to Assemble (http://localhost:4200/api/assemble) or Preview (http://localhost:4200/api/preview) require a POST body of valid JSON. Consider the following format:

{
	"units": [
		{
			"name": "standard-base",
			"build_size": "300x250",
			"build_source": {
				"build_source_path": "./standard-base/"
			},
			"build_source_options": {
				"stub_paths": [
					"./AD-BASE/options/sample-uicomponents/stub.json"
				]
			}
		}
	]
}

Additional URL parameters are:

  • &reinstall Optional, @string: "top", "build" - forces the reinstall of requested package.json
  • &hooks Optional, @boolean: if truthy, hooks will not be removed from the build-source. Helpful for debugging
  • &verbose Optional, @boolean: if truthy, processes log more output to stdout

Build Source Management

Build Sources are a hierarchy of code snippets & assets that are mapped with a collection of stub.json and are rendered with an internal python engine. These sources can be found in the ./build_sources folder.

If you want to make edits to the Build Sources, you must learn the "Stub Map" system. These docs are currently internal only: https://confluence.ff0000.com/display/AT/Technical+Overview

Build Source Map

In order to keep the UI snappy, available build sources (http://localhost:4200/api/list) are pre-mapped to ./build_sources/_build_source_maps.json.

This map needs to be updated when you change the top level folder-naming or -structure in ./build_sources.

The following route updates the map:

http://localhost:4200/api/refresh