UNPKG

@superflycss/pli

Version:

Standard directory layout for all SuperflyCSS modules

63 lines (47 loc) 3.53 kB
# SuperflyCSS Project Layout Instance (PLI) The PLI (Project Layout Instance) is a javascript object model of the standard directory layout that all [SuperflyCSS](https://github.com/superfly-css/superfly-css/) modules use. The standard layout enables users to instantly feel at home in any one of the [SuperflyCSS](https://github.com/superfly-css/superfly-css/) modules. The PLI is inspired by the [Apache Maven Standard Directory Layout](https://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html). ## Directory Descriptions The following directories are modeled by the PLI. ### Source Directories | Directory | Summary | |:------------------|:----------------------------------------------------------| | src/main/css | Entry level CSS module(s) are contained in this directory | | src/main/sss | Entry level SSS module(s) are contained in this directory | | src/main/js | Javascript supporting dynamic demoes | | src/main/html | Dynamic demonstrations | | src/main/nunjucks | Nunjucks Templates | | src/test/css | CSS test utilities | | src/test/sss | SSS test utilities | | src/test/js | Javascript supporting CSS unit tests | | src/test/html | Html pages for loading the unit tests | | src/test/nunjucks | Nunjucks Template unit tests | ### Target Directories | Directory | Summary | |:---------------------|:-----------------------------------| | target/main/css | Built CSS modules | | target/main/js | Built javascript | | target/main/html | Built dynamic demo html pages | | target/main/nunjucks | Precompiled Nunjucks Templates | | target/test/css | Built test CSS utilities | | target/test/js | Built test Javascript | | target/test/html | Built test html | | target/test/nunjucks | Built Nunjucks Template unit tests | ### Deploy Directories Resources that are contained in the `deploy` directory are intended to be served by `gh-pages` for all superfly-css repositories. Resources placed in these directories are optimized by [superfly-css-task-deploy](https://github.com/superfly-css/superfly-css-task-deploy). | Directory | Summary | |:---------------------|:----------------------------------------| | deploy/main/css | Deployable CSS modules | | deploy/main/js | Deployable javascript | | deploy/main/html | Deployable dynamic demo html pages | | deploy/main/nunjucks | Deployable Nunjucks Templates | | deploy/test/css | Deployable test CSS utilities | | deploy/test/js | Deployable test Javascript | | deploy/test/html | Deployable test html | | deploy/test/nunjucks | Deployable Nunjucks Template unit tests | ## Extension More directories can easily be added, and will naturally fit with the build methodology. For example: | Directory | Summary | |:---------------------|:---------------| | src/main/coffescript | Coffescript | | src/main/jade | Jade templates |