Skip to content

dahln/darknote

Repository files navigation

CI/CD

What & Why

Darknote is a SaaS, open-source, user-friendly, minimal notes app. It allows users to create notes and lists and share notes and lists with other people.

Because this project is open-source, you can deploy this application how and where you want. You control the data.

Demo

https://darknote.org#HowTo

Technologies

Getting Started

You can run this project locally.

Requirements: You must have the ASP.NET Core Runtime installed.

  1. Navigate to the project root folder
  2. run this command: "dotnet watch --project .\Darknote.API"
  3. This command will startup the application and create the required Sqlite database file.
  4. Register an account and sign-in.

Deployment Instructions

A tutorial on deploying is coming soon.

This project uses SendGrid to send emails. A SendGrid API key is required. You will need to specify your own SendGrid API key and system email address in the admin settings page. Some features that require email are not available until you provide the necessary SendGrid values. It is a simple process to create your own SendGrid account and retreive your API key.

Why SQLite?

It runs on Windows and Linux. Moving and controlling your data is easy. If you need more than SQLite offers then I recommend switching to Azure SQL. If you switch to Azure SQL, besure to delete your SQLite DB migrations and create new a 'Initial Migration' for your new Azure SQL DB.

Licensing

Refer to the LICENSE file