Skip to content

Fullstack AWS template with React, Node.js/TypeScript, DynamoDB, and GitHub Actions. Deploy instantly: ideal for solo devs, interviews, and rapid prototyping.

License

Notifications You must be signed in to change notification settings

Jagoda11/aws-fullstack-template

🚀 TypeScript Full-Stack Template

License Open Issues Last Commit Build Status TypeScript Build Status

This project is a monorepo template for a full-stack TypeScript application with:

  • Backend: Node.js (Express) with TypeScript
  • Frontend: React + Vite + Tailwind CSS
  • Tooling: ESLint, Prettier, Jest

📦 Project Structure

aws-fullstack-template/
├── backend/      # Node.js backend (TypeScript)
├── frontend/     # React frontend (Vite, Tailwind, TypeScript)
├── test/         # Shared tests
├── ...           # Root config, scripts, docs

🚀 Getting Started

  1. Install dependencies:

    npm install
  2. Run the backend:

    npm start

    This builds and starts the backend server from the root.

  3. Run the frontend (in a separate terminal):

    cd frontend
    npm run dev

    This starts the Vite dev server at http://localhost:5173


📜 Useful Scripts

Run these from the root unless otherwise noted:

  • start – Build and start the backend server
  • build – Build both backend and frontend
  • build:backend – Build backend only
  • build:frontend– Build frontend only
  • test – Run Jest tests with coverage
  • format – Format code with Prettier
  • lint – Lint all code with ESLint
  • lint:frontend – Lint frontend code
  • lint:backend – Lint backend code
  • clean – Remove build artifacts and dependencies

See package.json for the full list.


🤖 GitHub Actions

This repo includes CI workflows for build, test, and dependency updates. See .github/workflows/ for details.

This template includes several GitHub Actions workflows that automate various tasks:

  • 🚀ci.yml – Runs your project's continuous integration (CI) tasks
  • 🔐close-merged-pull-requests.yml – Automatically closes pull requests that have been merged
  • ⏳close-stale-issues-and-prs.yml – Closes stale issues and pull requests
  • 🏷️label-new-pull-requests.yml – Automatically adds labels to new pull requests
  • 🙏thank-contributors-on-issue-close.yml – Thanks contributors when an issue they commented on is closed
  • 👋welcome-new-pull-requests.yml – Posts a welcome message on new pull requests
  • 👋welcome.yml – Posts a welcome message on new issues
  • ⬆️npm-update.yml – Runs every day and updates package.json with new versions of dependencies
  • 🧹remove-stale-unmerged-branches.yml – Remove stale unmerged branches
  • 🧹remove-merged-branches.yml – Remove merged Branches

These workflows use the secrets.GITHUB_TOKEN secret, which GitHub automatically creates for every repository. You can create a personal access token and add it as a secret in your repository. For more information, see Creating and storing encrypted secrets.


🤝 Contributing

Contributions are welcome! Please read the Contributing Guide and Code of Conduct.


📝 License

MIT © 2024 Jagoda11

About

Fullstack AWS template with React, Node.js/TypeScript, DynamoDB, and GitHub Actions. Deploy instantly: ideal for solo devs, interviews, and rapid prototyping.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published

Contributors 2

  •  
  •