Welcome to the EventStoreDB's "From Scratch" series

.NET edition

Cook up your own tasty recipes by following the examples in the "FromScratch" series:

1. .NET
2. Node.js
3. Python
4. Java

The FromScratch series provides a practical path to learning a new framework. Follow this thorough set of instructions and example code to successfully complete your initial project.

Goals of the project

The Event Store Academy team wrote these in adherence to the following design goals.

1. Solve the "Doesn't run on my machine" problem by configuring and verifying success in GitHub codespaces
2. Clearly provide and explain all dependencies
3. Include instructions to configure locally, including setting up a development environment

The From Scratch content provides EVERYTHING you need to get started in ONE place.

Using this repo

1. Start with Codespaces

A fast path to successfully running this code is to utilize GitHub Codespaces.

For more info on Codespaces, please visit https://github.com/features/codespaces.

At the time of this writing, all GitHub users receive 60 hours/month of free access to codespaces for non-commercial use. All you need to get started is a GitHub account.

Instructions for Running this code in Codespaces is available as a pdf here Instructions For Running in Codespaces

2. Cloning this Repo and Running Locally on your computer

The steps needed to run this repository locally are included as a pdf. Instructions For Running Locally

The main difference between running in Codespaces and running locally is that you will need to install Docker so that you can run the EventStoreDB Docker container. You will also need to install either a JDK, a .NET SDK, Python, or Node.JS, depending on which of the "From Scratch" projects you are running. Please see the "Instructions for Running Locally" document for details.

3. Setting up a local environment

This document describes the steps we took to build these examples, including:

• installing the programming language
• creating a directory
• setting up the required additional tools

Also included are the steps you should take to prepare your code for sharing on GitHub, either publicly or privately within your organization.

These steps include:

• initializing a directory for git
• adding a .gitignore file
• pushing your first commit

Those steps are in this document Setting up a local environment From Scratch

Next Steps and Other Resources

Upon successful completion of your "From Scratch" project, you can continue practicing with the examples at https://github.com/EventStore/samples.

In particular, the Quickstart examples contain more thorough examples and include content using Go, Spring Boot, and Rust.

Supporting Documents

Included in the top-level directory are the required resources:

1. A PDF Instructions For Running in CodeSpaces outlining the steps needed to launch codespaces.
2. A PDF Instructions For Running Locally describing how to run EventStoreDB locally, including step-by-step details on how we built the project.
3. A PDF Setting Up A Local Environment describes the steps taken to build this project that can be used as a template to get started on similar projects.

Most of all, have fun! Once you know how to write and read events "From Scratch," you will be ready to cook up all sorts of tasty and more advanced recipes.