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

@baselinejs/core

v0.0.18

Published

Baseline JS is a serverless first full-stack JavaScript framework for building modern web applications.

Downloads

318

Readme

1688515420018

BaselineJS

BaselineJS is an open-source, fullstack TypeScript, serverless first framework designed to make building cloud native applications easier. Our framework utilizes a combination of modern technologies, architectures and operational processes to help teams to efficiently build and deploy robust applications

If you like BaselineJS give us a ⭐️

Website | Documentation | Discord | LinkedIn | YouTube

Startups, want $10k USD of AWS Credits to Get Started? Apply Here

Getting Started

Videos Walkthroughs

Video walkthroughs setting up Baseline

Setup

Quick Start

npx @baselinejs/quickstart

The quick start command will:

  • Install all requirements
  • Create a new Baseline project
  • Set up AWS credentials
  • Deploy to staging
  • Create an admin user
  • Output the URLs for the project

You may need to install npm if npx is not available, you can do this by installing Node.js

Setup

If you prefer a more manual setup, follow the steps below.

  1. Install requirements pnpm run install:requirements
  2. npx @baselinejs/create-app my-app-name
  3. pnpm install
  4. pnpm run setup to name your project and set the region
  5. pnpm run aws:profile to setup your AWS credentials profile (if you have issues please update aws cli)
  6. pnpm run deploy:staging to deploy api/web/admin
  7. pnpm run add:user:staging to add an admin user to the application
  8. pnpm run urls:staging To see your project URLs

Local Requirements

These must be installed before following the setup instructions. These can be installed manually or by using the requirements installation script.

Requirements Installation

Run the following command to install the requirements.

If you are starting a new Baseline project.

curl -o- https://raw.githubusercontent.com/Baseline-JS/core/main/scripts/install-requirements.sh | bash

or

wget -qO- https://raw.githubusercontent.com/Baseline-JS/core/main/scripts/install-requirements.sh | bash

If you are joining an existing Baseline project make sure you run the requirements installation script in the root of the project. This will install the requirements for the project.

pnpm run install:requirements

Run Locally

If the project is already setup and you are trying run the project locally make sure you run pnpm run aws:profile first so that you have the correct credentials for AWS configured locally.

Commands

Start the api, admin and web in their own terminal windows/tabs with the following commands.

  1. pnpm run generate:env:local to generate the env files for the frontend clients
  2. pnpm run start:api
  3. pnpm run start:admin
  4. pnpm run start:web

Running locally Limitations

  • API, Web & Admin: No S3, you will need to rely on AWS staging S3
  • API: No local Cognito Authorizer, the deployed staging cognito can be used (see packages/api/serverless.yml) or the payload set by AUTHORIZER in packages/api/scripts/run-api-local.sh.
  • Admin: Cognito UI relies on an active AWS Cognito user pool, use deployed staging

Deploy a Change

Swap staging to prod to deploy to production. All environment variables will be automatically set in the process.

  1. pnpm run deploy:staging to deploy api/web/admin

Remove Stack

To destroy the deployed cloudformation stacks so it is no longer on AWS run pnpm run remove:staging. This will likely destroy all data associated with the application.

Major Components

  • 🚀 API
  • 🖥️ React Admin Website
  • 🌐 React User Website
  • ⚙️ CI/CD
  • 🔧 Developer Tooling
  • 🔒 Authentication
  • 🔄 Multiple Environments
  • 💻 Run Locally
  • 🏗️ Infrastructure as Code (IaC)
  • 📦 Managed Environment Variables
  • ✨ Baseline Commands

Technology

  • 🎁 Package Management: Pnpm + Monorepo
  • 🔨 Language & Build: TypeScript + ESBuild
  • 🖼 Frontend: React + Vite
  • ⚙️ Backend: NodeJS + Express
  • 🎨 Linting & Formatting: Prettier + Eslint
  • 🏗 IaC: AWS + Serverless Framework
  • 🚀 Deploy: Local/Bitbucket/GitHub CI/CD

AWS Services

  • Cognito
  • S3
  • Lambda
  • DynamoDB
  • CloudFormation
  • Route53
  • Systems Manager
  • CloudFront
  • API Gateway
  • CloudWatch
  • SNS

What can you build with Baseline?

  • 🌐 SaaS Solutions: Build software-as-a-service solutions tailored to your audience.
  • 🖥️ Web Applications: Develop responsive and scalable web applications.
  • 🛒 Marketplaces: Launch and manage online marketplaces with ease.
  • 📱 Mobile Applications: Create robust mobile apps for iOS and Android platforms.
  • 💼🛍️ B2B/B2C Applications: Seamlessly cater to both business and consumer audiences.
  • 🗄️ Headless CMS: Manage content efficiently using a headless content management system.

Benefits

  • Serverless First
  • Open source
  • Full control
  • Cost effective implementation
  • Hosted in your own AWS account
  • Uses popular technology
  • Scales on demand
  • Staging and production environments
  • Runs locally

Baseline

If you would like to learn more about what we do please visit Baseline