2.23.0 • Published 6 months ago

@adbayb/stack v2.23.0

Weekly downloads
-
License
MIT
Repository
github
Last release
6 months ago

✨ Features

Stack allows creating an NPM project in a quick, easy and opinionated way with:

  • A unified monorepo-driven and git-driven approach for all kinds of projects (single-purpose library, multiple libraries, application(s), ...)
  • Support for several application templates (for now, only a default template is available, but others can be added later)
  • Standardized file structure including optional folder creation such as examples, packages, ...
  • Enable all project lifecycle steps with commands from the setup, check, fix, build, and test to the versioning and release
  • Built-in configuration preset setup (including Node/NPM runtime, Git ignore/hooks, TypeScript, ESLint, Prettier, EditorConfig, Renovate, Changesets, and VSCode)
  • A welcoming environment for users and contributors with the continuous integration setup, and the creation of README.md, CONTRIBUTING.md, and GitHub template files (including issue and pull request ones), ...
  • An optimized development environment with command caching (no build needed if nothing changes)

🚀 Usage

This section introduces the stack essentials by walking through its main commands:

1️⃣ Create the NPM project via the @adbayb/create initializer:

# Npm
npm init @adbayb
# Pnpm
pnpm create @adbayb

2️⃣ Play with available commands (already set up in the generated root package.json):

# Setup initial requirements (including Git hooks installation)
stack install
# Clean the project
stack clean
# Check code health (static analysis including linters, types, and commit message)
stack check
# Fix auto-fixable issues
stack fix
# Start the project in production mode
stack start
# Build the project in production mode
stack build
# Build and start the project in development mode
stack watch
# Test the code execution
stack test
# Log, version, and publish package(s)
stack release

3️⃣ Enjoy!

🌍 Ecosystem

Available configurations

Used technologies

  • Static code analysis: ESLint, Prettier
  • Node package manager: PNPM
  • Task orchestration: Turborepo
  • Release: Changesets
  • Testing: Vitest

Used conventions

  • Commits
  • Scripts
  • File Structure
    • Monorepo-first structure to:
      • Keep a consistent file structure pattern across templates (ease template familiarity and onboarding).
      • Ease examples setup.
      • Not clutter the published package with development-related context, metadata, and artifacts.

🏗️ Architecture

Project creation workflow

flowchart TD
    N("npm init @adbayb"):::strokeWidth -- Runs --> C("@adbayb/create"):::strokeWidth
    C -- Runs --> S("@adbayb/stack create"):::strokeWidth
    S -- "Scaffolds (via template and shared configurations)" --> P("New project"):::strokeWidth
    style C fill:#daf2d7,stroke:#90cf8e
    style S fill:#daf2d7,stroke:#90cf8e
    classDef strokeWidth stroke-width:3px

✍️ Contribution

We're open to new contributions, you can find more details here.

📖 License

MIT

0.0.0-next-fa0735e

11 months ago

0.0.0-next-b5c484b

10 months ago

0.0.0-next-a66d467

11 months ago

0.0.0-next-c00acf0

11 months ago

0.0.0-next-4a1a044

11 months ago

2.11.0

10 months ago

0.0.0-next-b1bf753

9 months ago

0.0.0-next-695c49a

11 months ago

0.0.0-next-711fb0a

11 months ago

2.4.0

11 months ago

2.8.0

11 months ago

0.0.0-next-c6840d7

11 months ago

2.0.0

12 months ago

0.0.0-next-949e218

10 months ago

0.0.0-next-f1ca685

11 months ago

2.19.0

8 months ago

2.15.0

9 months ago

2.22.0

7 months ago

0.0.0-next-f9070af

12 months ago

0.0.0-next-b891d6c

11 months ago

0.0.0-next-fd6185e

11 months ago

0.0.0-next-400d90f

10 months ago

0.0.0-next-beb94a3

12 months ago

0.0.0-next-f3b94c9

12 months ago

0.0.0-next-86186df

8 months ago

0.0.0-next-184fcc6

10 months ago

0.0.0-next-c066f8e

9 months ago

0.0.0-next-f8bba1c

10 months ago

0.0.0-next-c6727b1

11 months ago

2.3.0

11 months ago

2.10.0

10 months ago

2.3.1

11 months ago

2.7.0

11 months ago

0.0.0-next-06abf09

9 months ago

0.0.0-next-c0ca691

11 months ago

0.0.0-next-6c844b5

8 months ago

0.0.0-next-03de63d

11 months ago

0.0.0-next-98b9c0a

9 months ago

2.18.0

8 months ago

0.0.0-next-389cf5e

11 months ago

2.14.0

10 months ago

2.21.0

7 months ago

0.0.0-next-ef282d9

10 months ago

0.0.0-next-4da7c72

8 months ago

0.0.0-next-153043d

11 months ago

0.0.0-next-9833c9d

7 months ago

0.0.0-next-9cabdc2

12 months ago

0.0.0-next-171af47

11 months ago

0.0.0-next-3f75848

11 months ago

2.2.0

12 months ago

0.0.0-next-6d1495c

11 months ago

2.6.1

11 months ago

2.6.0

11 months ago

0.0.0-next-ca3103e

6 months ago

0.0.0-next-89c138a

9 months ago

2.6.2

11 months ago

0.0.0-next-387517b

11 months ago

0.0.0-next-b978ac8

8 months ago

0.0.0-next-2e5f625

10 months ago

0.0.0-next-95e93ca

7 months ago

0.0.0-next-be3ee80

7 months ago

0.0.0-next-4a80b53

8 months ago

2.17.0

8 months ago

2.17.1

8 months ago

0.0.0-next-f366c38

8 months ago

2.13.0

10 months ago

2.20.0

8 months ago

0.0.0-next-c2c7b7c

12 months ago

0.0.0-next-ece28ab

12 months ago

0.0.0-next-343e0e5

10 months ago

0.0.0-next-b4182bc

8 months ago

0.0.0-next-c2ead0b

11 months ago

0.0.0-next-0f6c3a3

11 months ago

0.0.0-next-81b54cb

12 months ago

0.0.0-next-bb12fc2

10 months ago

0.0.0-next-b4e7dd3

11 months ago

2.12.0

10 months ago

2.5.0

11 months ago

0.0.0-next-a2e83d0

10 months ago

2.9.0

10 months ago

0.0.0-next-7c8d608

10 months ago

0.0.0-next-f4f1804

12 months ago

0.0.0-next-e5749e5

11 months ago

0.0.0-next-f1346b3

9 months ago

2.1.0

12 months ago

0.0.0-next-5133546

12 months ago

0.0.0-next-4df72a5

10 months ago

0.0.0-next-51dd413

6 months ago

2.16.0

9 months ago

0.0.0-next-f8eca33

12 months ago

0.0.0-next-df02a77

12 months ago

2.23.0

6 months ago

0.0.0-next-9ab8a09

8 months ago

0.0.0-next-b487c31

12 months ago

0.0.0-next-ab05550

12 months ago

0.0.0-next-2465bfc

11 months ago

0.0.0-next-0af2848

10 months ago

0.0.0-next-730a06d

12 months ago

0.0.0-next-d23a669

12 months ago

0.0.0-next-1dfe647

12 months ago

0.0.0-next-912a585

12 months ago

0.0.0-next-1ee86fc

12 months ago

0.0.0-next-2ad39fd

12 months ago

0.0.0-next-84ccbde

12 months ago

0.0.0-next-a8b5c70

12 months ago

0.0.0-next-2a0b6a2

12 months ago

0.0.0-next-d3d6a87

12 months ago

0.0.0-next-9c647dc

12 months ago

0.0.0-next-2add8bc

12 months ago

0.0.0-next-798693b

12 months ago

0.0.0-next-3855dc4

12 months ago

0.0.0-next-4a5e303

12 months ago

0.0.0-next-c59d48f

12 months ago

0.0.0-next-2c3f9c4

12 months ago

0.0.0-next-b8a4412

12 months ago

0.0.0-next-c7f4869

12 months ago

0.0.0-next-023d8d0

12 months ago

0.0.0-next-65bf474

12 months ago

0.0.0-next-5671759

12 months ago

0.0.0-next-a1aa6ca

12 months ago

0.0.0-next-91f24f2

12 months ago

0.0.0-next-66d9b95

12 months ago

1.16.1

2 years ago

1.16.0

2 years ago

1.15.0

2 years ago

1.14.0

2 years ago

1.13.0

2 years ago

1.12.0

2 years ago

1.11.0

2 years ago

1.10.0

2 years ago

1.9.0

2 years ago

1.8.1

2 years ago

1.8.0

2 years ago

1.7.0

2 years ago

1.6.0

2 years ago

1.5.1

2 years ago

1.5.0

2 years ago

1.4.0

2 years ago

1.3.0

2 years ago

1.2.0

2 years ago

1.1.0

2 years ago

1.0.0

2 years ago