Update both README and LICENSE (still ISC)
This commit is contained in:
		
							
								
								
									
										4
									
								
								LICENSE
									
									
									
									
									
								
							
							
						
						
									
										4
									
								
								LICENSE
									
									
									
									
									
								
							| @ -1,4 +1,6 @@ | |||||||
| Copyright 2022 James Eversole (james@eversole.co) | ISC LICENSE | ||||||
|  |  | ||||||
|  | Copyright James Eversole (james@eversole.co) | ||||||
|  |  | ||||||
| Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. | Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. | ||||||
|  |  | ||||||
|  | |||||||
							
								
								
									
										51
									
								
								README
									
									
									
									
									
								
							
							
						
						
									
										51
									
								
								README
									
									
									
									
									
								
							| @ -1,51 +0,0 @@ | |||||||
| purr |  | ||||||
| ----- |  | ||||||
|  |  | ||||||
| https://purr.eversole.co  |  | ||||||
| a work-in-progress web application offering customizable password generation  |  | ||||||
| and time-limited sharing of secrets. |  | ||||||
|  |  | ||||||
| TECH STACK |  | ||||||
|  |  | ||||||
| - Haskell and Scotty backend |  | ||||||
| - HTMX frontend |  | ||||||
| - SQLite database |  | ||||||
|  |  | ||||||
| GOALS |  | ||||||
|  |  | ||||||
| - Generate sufficiently memorable but secure passwords for use with accounts  |  | ||||||
| that don't offer better authentication methods. |  | ||||||
|  |  | ||||||
| - Share text secrets with others without disclosing the secret in the  |  | ||||||
| message itself.  |  | ||||||
|  |  | ||||||
| - Provide a minimal and clean interface for generating and sharing passwords. |  | ||||||
|  |  | ||||||
| - Maintain a clean and organized codebase that can be extended to include more |  | ||||||
| utilities than originally anticipated. |  | ||||||
|  |  | ||||||
| - Be really cute compared to the competition. |  | ||||||
|  |  | ||||||
| WHY TRUST YOU? |  | ||||||
|  |  | ||||||
| You shouldn't. This is free and open-source software which you can run on your  |  | ||||||
| own hardware. |  | ||||||
|  |  | ||||||
| DEPLOYMENT |  | ||||||
|  |  | ||||||
| Only Nix build instructions targeting containers are provided below,  |  | ||||||
| but this project can be built and run without containers or Nix using Cabal. |  | ||||||
|  |  | ||||||
| - Clone this repository |  | ||||||
| - Build the container image (with flakes enabled): `nix build .#purr-container` |  | ||||||
| - Load the container image |  | ||||||
|   - podman load -i result |  | ||||||
| - Use the provided docker stack example to deploy the container if desired |  | ||||||
|   - docker stack deploy -c docker-stack.yml purr |  | ||||||
|  |  | ||||||
| DEVELOPMENT & SUPPORT |  | ||||||
|  |  | ||||||
| Per the permissive ISC license, you are free to do what you wish with this software. I hold |  | ||||||
| no liability for any defects and no guarantees are made to its usability. |  | ||||||
|  |  | ||||||
| Copyright James Eversole (james@eversole.co) |  | ||||||
							
								
								
									
										67
									
								
								README.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										67
									
								
								README.md
									
									
									
									
									
										Normal file
									
								
							| @ -0,0 +1,67 @@ | |||||||
|  | # purr | ||||||
|  |  | ||||||
|  | [purr.eversole.co](https://purr.eversole.co) | ||||||
|  |  | ||||||
|  | a simple web application offering customizable password generation  | ||||||
|  | and time-limited sharing of secrets. | ||||||
|  |  | ||||||
|  | ## TECH STACK | ||||||
|  |  | ||||||
|  | - [Haskell](https://www.haskell.org) | ||||||
|  | - [Scotty](https://hackage.haskell.org/package/scotty) | ||||||
|  | - [HTMX](https://htmx.org) | ||||||
|  | - [SQLite](https://www.sqlite.org) | ||||||
|  |  | ||||||
|  | ## GOALS | ||||||
|  |  | ||||||
|  | - Provide a minimal and clean interface for generating and sharing passwords. | ||||||
|  | - Generate sufficiently memorable but secure passwords for use with accounts  | ||||||
|  | that don't offer better authentication methods. | ||||||
|  | - Share text secrets with others without disclosing the secret in the  | ||||||
|  | message itself. | ||||||
|  | - Maintain a clean and organized codebase that can be extended to include more | ||||||
|  | utilities than originally anticipated. | ||||||
|  |  | ||||||
|  | ## WHY TRUST PURR.EVERSOLE.CO? | ||||||
|  |  | ||||||
|  | You shouldn't. This is free and open-source software which you can run on your  | ||||||
|  | own hardware! | ||||||
|  |  | ||||||
|  | ## DEPLOYMENT | ||||||
|  |  | ||||||
|  | Only Nix build instructions targeting containers are provided below,  | ||||||
|  | but this project can be built and run without containers or Nix by using Cabal. | ||||||
|  |  | ||||||
|  | 1) Clone this repository | ||||||
|  | 2) Build the container image (with flakes enabled): `nix build .#purr-container` | ||||||
|  | 3) Load the container image | ||||||
|  |     - podman load -i result | ||||||
|  | 4) NixOS configuration: | ||||||
|  | ``` | ||||||
|  | virtualisation.oci-containers.containers.purr = { | ||||||
|  |   image = "purr"; | ||||||
|  |   ports = [ "${PURR_EXTERNAL_PORT}:3000" ]; | ||||||
|  |   volumes = [ | ||||||
|  |     "/PATH/TO/PURR/data:/app/data" | ||||||
|  |   ]; | ||||||
|  |   environment = {  | ||||||
|  |     PURRNOFILE = "true"; | ||||||
|  |     ENVIRONMENT = "production"; | ||||||
|  |     APPLICATIONHOST = "localhost"; | ||||||
|  |     APPLICATIONPORT = "3000"; | ||||||
|  |     DATADIR = "/app/"; | ||||||
|  |     LINKLENGTH = "24"; | ||||||
|  |     ADMINEMAIL = "${YOUR_EMAIL}"; | ||||||
|  |   }; | ||||||
|  | }; | ||||||
|  | ``` | ||||||
|  | 5) Docker Stack | ||||||
|  |     1) Set environment variables in docker-stack.yml or mount a .env file. | ||||||
|  |     2) `docker stack deploy -c docker-stack.yml purr` | ||||||
|  |  | ||||||
|  | ## DEVELOPMENT & SUPPORT | ||||||
|  |  | ||||||
|  | Per the permissive ISC license, you are free to do what you wish with this | ||||||
|  | software. No guarantees are made to its usability, security, or functionality. | ||||||
|  |  | ||||||
|  | Copyright James Eversole (james@eversole.co) | ||||||
		Reference in New Issue
	
	Block a user