Skip to content

๐Ÿ›  Node.js + TypeScript with all the goods: A zero-to-coding starter kit with all the modern tooling baked in.

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT
Notifications You must be signed in to change notification settings

postlight/nodejs-typescript-kit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

77 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Node.js + TypeScript Starter Kit

Node.js + TypeScript Starter Kit

code style: prettier CircleCI

Postlight's Node.js + TypeScript Starter Kit is a zero-config codebase that lets you start writing code immediately. It includes:

  • TypeScript (or write just regular ol' JavaScript)
  • Jest for testing
  • Prettier for formatting
  • ESLint for linting
  • CircleCI configs
  • Pre-commit hooks
  • Basic config and build scripts

Read all about it this handy introduction.

Creating a project

Create the project by using npx:

npx comes with npm 5.2+ and higher

npx @postlight/node-typescript-starter-kit my-awesome-project

cd my-awesome-project

Install dependencies using either yarn or npm

yarn install

#  or

npm install

And you can directly start coding!

starterkit

Starter Kit Documentation

Development

For development, we'll assume you're using yarn, but if you're using npm instead, adjust the commands appropriately (namely, replace yarn with npm run).

For running an individual .ts file:

yarn ts-node <file.ts>

For development mode:

yarn nodemon

nodemon will automatically restart the application when file changes are detected. This is useful if the tool you're building executes code when run.

Linting

yarn lint

VSCode users should add this to their workspace settings to integrate JS/TS linting in general:

  "eslint.validate": [
    "javascript",
    "typescript",
  ]

Running tests

Run all tests:

yarn test

Run and watch all tests:

yarn test:watch

Building the App

yarn build

Building your app with CircleCI

Having already pushed your project to your favorite git repository hosting service, you're one click away from integrating your app with CircleCI.

  • Login to CircleCI
  • On the left side menu, press Add Projects.
  • Pinpoint your project and press Set Up Project.
  • Choose Linux as the OS and Node as the language.
  • Press Start Building, and you're all set! ๐ŸŽ‰

CircleCI ensures that every commit is checked for errors before merging. This basic setup runs yarn lint, yarn test, and yarn build.


๐Ÿ”ฌ A Labs project from your friends at Postlight. Happy coding!

About

๐Ÿ›  Node.js + TypeScript with all the goods: A zero-to-coding starter kit with all the modern tooling baked in.

Topics

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Packages

No packages published